--- clutter-1.0-1.2.4.orig/doc/reference/cogl/html/index.html +++ clutter-1.0-1.2.4/doc/reference/cogl/html/index.html @@ -6,7 +6,7 @@ - + @@ -26,7 +26,7 @@
-

+

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later @@ -111,6 +111,6 @@

+ Generated by GTK-Doc V1.11
- \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/cogl/html/cogl-Materials.html +++ clutter-1.0-1.2.4/doc/reference/cogl/html/cogl-Materials.html @@ -8,7 +8,7 @@ - + @@ -30,8 +30,8 @@ Top -  |  - Description +  |  + Description
@@ -45,87 +45,108 @@

Synopsis

-
CoglHandle          cogl_material_new                   (void);
-CoglHandle          cogl_material_copy                  (CoglHandle source);
-CoglHandle          cogl_material_ref                   (CoglHandle handle);
-void                cogl_material_unref                 (CoglHandle handle);
-gboolean            cogl_is_material                    (CoglHandle handle);
-void                cogl_material_set_color             (CoglHandle material,
-                                                         const CoglColor *color);
-void                cogl_material_set_color4ub          (CoglHandle material,
-                                                         guint8 red,
-                                                         guint8 green,
-                                                         guint8 blue,
-                                                         guint8 alpha);
-void                cogl_material_set_color4f           (CoglHandle material,
-                                                         float red,
-                                                         float green,
-                                                         float blue,
-                                                         float alpha);
-void                cogl_material_get_color             (CoglHandle material,
-                                                         CoglColor *color);
-void                cogl_material_set_ambient           (CoglHandle material,
-                                                         const CoglColor *ambient);
-void                cogl_material_get_ambient           (CoglHandle material,
-                                                         CoglColor *ambient);
-void                cogl_material_set_diffuse           (CoglHandle material,
-                                                         const CoglColor *diffuse);
-void                cogl_material_get_diffuse           (CoglHandle material,
-                                                         CoglColor *diffuse);
-void                cogl_material_set_ambient_and_diffuse
-                                                        (CoglHandle material,
-                                                         const CoglColor *color);
-void                cogl_material_set_emission          (CoglHandle material,
-                                                         const CoglColor *emission);
-void                cogl_material_get_emission          (CoglHandle material,
-                                                         CoglColor *emission);
-void                cogl_material_set_specular          (CoglHandle material,
-                                                         const CoglColor *specular);
-void                cogl_material_get_specular          (CoglHandle material,
-                                                         CoglColor *specular);
-void                cogl_material_set_shininess         (CoglHandle material,
-                                                         float shininess);
-float               cogl_material_get_shininess         (CoglHandle material);
+
+CoglHandle          cogl_material_new                   (void);
+CoglHandle          cogl_material_copy                  (CoglHandle source);
+CoglHandle          cogl_material_ref                   (CoglHandle handle);
+void                cogl_material_unref                 (CoglHandle handle);
+gboolean            cogl_is_material                    (CoglHandle handle);
+void                cogl_material_set_color             (CoglHandle material,
+                                                         const CoglColor *color);
+void                cogl_material_set_color4ub          (CoglHandle material,
+                                                         guint8 red,
+                                                         guint8 green,
+                                                         guint8 blue,
+                                                         guint8 alpha);
+void                cogl_material_set_color4f           (CoglHandle material,
+                                                         float red,
+                                                         float green,
+                                                         float blue,
+                                                         float alpha);
+void                cogl_material_get_color             (CoglHandle material,
+                                                         CoglColor *color);
+void                cogl_material_set_ambient           (CoglHandle material,
+                                                         const CoglColor *ambient);
+void                cogl_material_get_ambient           (CoglHandle material,
+                                                         CoglColor *ambient);
+void                cogl_material_set_diffuse           (CoglHandle material,
+                                                         const CoglColor *diffuse);
+void                cogl_material_get_diffuse           (CoglHandle material,
+                                                         CoglColor *diffuse);
+void                cogl_material_set_ambient_and_diffuse
+                                                        (CoglHandle material,
+                                                         const CoglColor *color);
+void                cogl_material_set_emission          (CoglHandle material,
+                                                         const CoglColor *emission);
+void                cogl_material_get_emission          (CoglHandle material,
+                                                         CoglColor *emission);
+void                cogl_material_set_specular          (CoglHandle material,
+                                                         const CoglColor *specular);
+void                cogl_material_get_specular          (CoglHandle material,
+                                                         CoglColor *specular);
+void                cogl_material_set_shininess         (CoglHandle material,
+                                                         float shininess);
+float               cogl_material_get_shininess         (CoglHandle material);
 enum                CoglMaterialAlphaFunc;
-void                cogl_material_set_alpha_test_function
-                                                        (CoglHandle material,
-                                                         CoglMaterialAlphaFunc alpha_func,
-                                                         float alpha_reference);
-#define             COGL_BLEND_STRING_ERROR
+void                cogl_material_set_alpha_test_function
+                                                        (CoglHandle material,
+                                                         CoglMaterialAlphaFunc alpha_func,
+                                                         float alpha_reference);
+#define             COGL_BLEND_STRING_ERROR
 enum                CoglBlendStringError;
-gboolean            cogl_material_set_blend             (CoglHandle material,
-                                                         const char *blend_string,
-                                                         GError **error);
-void                cogl_material_set_blend_constant    (CoglHandle material,
-                                                         CoglColor *constant_color);
-void                cogl_material_set_layer             (CoglHandle material,
-                                                         int layer_index,
-                                                         CoglHandle texture);
-void                cogl_material_remove_layer          (CoglHandle material,
-                                                         int layer_index);
-gboolean            cogl_material_set_layer_combine     (CoglHandle material,
-                                                         int layer_index,
-                                                         const char *blend_string,
-                                                         GError **error);
-void                cogl_material_set_layer_combine_constant
-                                                        (CoglHandle material,
-                                                         int layer_index,
-                                                         CoglColor *constant);
-void                cogl_material_set_layer_matrix      (CoglHandle material,
-                                                         int layer_index,
-                                                         CoglMatrix *matrix);
-const GList *       cogl_material_get_layers            (CoglHandle material);
-int                 cogl_material_get_n_layers          (CoglHandle material);
+gboolean            cogl_material_set_blend             (CoglHandle material,
+                                                         const char *blend_string,
+                                                         GError **error);
+void                cogl_material_set_blend_constant    (CoglHandle material,
+                                                         CoglColor *constant_color);
+void                cogl_material_set_layer             (CoglHandle material,
+                                                         int layer_index,
+                                                         CoglHandle texture);
+void                cogl_material_remove_layer          (CoglHandle material,
+                                                         int layer_index);
+gboolean            cogl_material_set_layer_combine     (CoglHandle material,
+                                                         int layer_index,
+                                                         const char *blend_string,
+                                                         GError **error);
+void                cogl_material_set_layer_combine_constant
+                                                        (CoglHandle material,
+                                                         int layer_index,
+                                                         CoglColor *constant);
+void                cogl_material_set_layer_matrix      (CoglHandle material,
+                                                         int layer_index,
+                                                         CoglMatrix *matrix);
+const GList *       cogl_material_get_layers            (CoglHandle material);
+int                 cogl_material_get_n_layers          (CoglHandle material);
 enum                CoglMaterialFilter;
-void                cogl_material_set_layer_filters     (CoglHandle material,
-                                                         int layer_index,
-                                                         CoglMaterialFilter min_filter,
-                                                         CoglMaterialFilter mag_filter);
+void                cogl_material_set_layer_filters     (CoglHandle material,
+                                                         int layer_index,
+                                                         CoglMaterialFilter min_filter,
+                                                         CoglMaterialFilter mag_filter);
 enum                CoglMaterialLayerType;
-CoglMaterialLayerType  cogl_material_layer_get_type     (CoglHandle layer);
-CoglHandle          cogl_material_layer_get_texture     (CoglHandle layer);
-CoglMaterialFilter  cogl_material_layer_get_min_filter  (CoglHandle layer);
-CoglMaterialFilter  cogl_material_layer_get_mag_filter  (CoglHandle layer);
+CoglMaterialLayerType  cogl_material_layer_get_type     (CoglHandle layer);
+CoglHandle          cogl_material_layer_get_texture     (CoglHandle layer);
+CoglMaterialFilter  cogl_material_layer_get_min_filter  (CoglHandle layer);
+CoglMaterialFilter  cogl_material_layer_get_mag_filter  (CoglHandle layer);
 
@@ -135,14 +156,18 @@ geometry. Materials may simply be lighting attributes (such as an ambient and diffuse colour) or might represent one or more textures blended together.

+

+

Details

cogl_material_new ()

-
CoglHandle          cogl_material_new                   (void);
+
CoglHandle          cogl_material_new                   (void);

Allocates and initializes a blank white material

+

+

@@ -155,7 +180,7 @@

cogl_material_copy ()

-
CoglHandle          cogl_material_copy                  (CoglHandle source);
+
CoglHandle          cogl_material_copy                  (CoglHandle source);

Creates a new material handle with the configuration copied from the source material. @@ -166,6 +191,8 @@ be any similarity between two materials. Copying a material helps Cogl keep track of a materials ancestry which we may use to help minimize GPU state changes.

+

+

@@ -187,13 +214,15 @@

cogl_material_ref ()

-
CoglHandle          cogl_material_ref                   (CoglHandle handle);
+
CoglHandle          cogl_material_ref                   (CoglHandle handle);

Warning

cogl_material_ref has been deprecated since version 1.2 and should not be used in newly-written code. Use cogl_handle_ref() instead

Increment the reference count for a cogl material.

+

+

@@ -215,13 +244,15 @@

cogl_material_unref ()

-
void                cogl_material_unref                 (CoglHandle handle);
+
void                cogl_material_unref                 (CoglHandle handle);

Warning

cogl_material_unref has been deprecated since version 1.2 and should not be used in newly-written code. Use cogl_handle_unref() instead

Decrement the reference count for a cogl material.

+

+

@@ -235,9 +266,13 @@

cogl_is_material ()

-
gboolean            cogl_is_material                    (CoglHandle handle);
+
gboolean            cogl_is_material                    (CoglHandle handle);

Gets whether the given handle references an existing material object.

+

+

@@ -248,8 +283,8 @@ - @@ -258,8 +293,8 @@

cogl_material_set_color ()

-
void                cogl_material_set_color             (CoglHandle material,
-                                                         const CoglColor *color);
+
void                cogl_material_set_color             (CoglHandle material,
+                                                         const CoglColor *color);

Sets the basic color of the material, used when no lighting is enabled.

@@ -271,6 +306,8 @@

The default value is (1.0, 1.0, 1.0, 1.0)

+

+

Returns :

TRUE if the handle references a CoglMaterial, - FALSE otherwise + TRUE if the handle references a CoglMaterial, + FALSE otherwise
@@ -291,16 +328,26 @@

cogl_material_set_color4ub ()

-
void                cogl_material_set_color4ub          (CoglHandle material,
-                                                         guint8 red,
-                                                         guint8 green,
-                                                         guint8 blue,
-                                                         guint8 alpha);
+
void                cogl_material_set_color4ub          (CoglHandle material,
+                                                         guint8 red,
+                                                         guint8 green,
+                                                         guint8 blue,
+                                                         guint8 alpha);

Sets the basic color of the material, used when no lighting is enabled.

The default value is (0xff, 0xff, 0xff, 0xff)

+

+

@@ -336,16 +383,18 @@

cogl_material_set_color4f ()

-
void                cogl_material_set_color4f           (CoglHandle material,
-                                                         float red,
-                                                         float green,
-                                                         float blue,
-                                                         float alpha);
+
void                cogl_material_set_color4f           (CoglHandle material,
+                                                         float red,
+                                                         float green,
+                                                         float blue,
+                                                         float alpha);

Sets the basic color of the material, used when no lighting is enabled.

The default value is (1.0, 1.0, 1.0, 1.0)

+

+

@@ -381,10 +430,12 @@

cogl_material_get_color ()

-
void                cogl_material_get_color             (CoglHandle material,
-                                                         CoglColor *color);
+
void                cogl_material_get_color             (CoglHandle material,
+                                                         CoglColor *color);

Retrieves the current material color.

+

+

@@ -404,8 +455,8 @@

cogl_material_set_ambient ()

-
void                cogl_material_set_ambient           (CoglHandle material,
-                                                         const CoglColor *ambient);
+
void                cogl_material_set_ambient           (CoglHandle material,
+                                                         const CoglColor *ambient);

Sets the material's ambient color, in the standard OpenGL lighting model. The ambient color affects the overall color of the object. @@ -417,6 +468,8 @@

The default value is (0.2, 0.2, 0.2, 1.0)

+

+

@@ -437,10 +490,12 @@

cogl_material_get_ambient ()

-
void                cogl_material_get_ambient           (CoglHandle material,
-                                                         CoglColor *ambient);
+
void                cogl_material_get_ambient           (CoglHandle material,
+                                                         CoglColor *ambient);

Retrieves the current ambient color for material

+

+

@@ -461,8 +516,8 @@

cogl_material_set_diffuse ()

-
void                cogl_material_set_diffuse           (CoglHandle material,
-                                                         const CoglColor *diffuse);
+
void                cogl_material_set_diffuse           (CoglHandle material,
+                                                         const CoglColor *diffuse);

Sets the material's diffuse color, in the standard OpenGL lighting model. The diffuse color is most intense where the light hits the @@ -470,6 +525,8 @@

The default value is (0.8, 0.8, 0.8, 1.0)

+

+

@@ -490,10 +547,12 @@

cogl_material_get_diffuse ()

-
void                cogl_material_get_diffuse           (CoglHandle material,
-                                                         CoglColor *diffuse);
+
void                cogl_material_get_diffuse           (CoglHandle material,
+                                                         CoglColor *diffuse);

Retrieves the current diffuse color for material

+

+

@@ -514,9 +573,9 @@

cogl_material_set_ambient_and_diffuse ()

-
void                cogl_material_set_ambient_and_diffuse
-                                                        (CoglHandle material,
-                                                         const CoglColor *color);
+
void                cogl_material_set_ambient_and_diffuse
+                                                        (CoglHandle material,
+                                                         const CoglColor *color);

Conveniently sets the diffuse and ambient color of material at the same time. See cogl_material_set_ambient() and cogl_material_set_diffuse(). @@ -526,6 +585,8 @@

The default diffuse color is (0.8, 0.8, 0.8, 1.0)

+

+

@@ -546,8 +607,8 @@

cogl_material_set_emission ()

-
void                cogl_material_set_emission          (CoglHandle material,
-                                                         const CoglColor *emission);
+
void                cogl_material_set_emission          (CoglHandle material,
+                                                         const CoglColor *emission);

Sets the material's emissive color, in the standard OpenGL lighting model. It will look like the surface is a light source emitting this @@ -555,6 +616,8 @@

The default value is (0.0, 0.0, 0.0, 1.0)

+

+

@@ -575,10 +638,12 @@

cogl_material_get_emission ()

-
void                cogl_material_get_emission          (CoglHandle material,
-                                                         CoglColor *emission);
+
void                cogl_material_get_emission          (CoglHandle material,
+                                                         CoglColor *emission);

Retrieves the materials current emission color.

+

+

@@ -599,8 +664,8 @@

cogl_material_set_specular ()

-
void                cogl_material_set_specular          (CoglHandle material,
-                                                         const CoglColor *specular);
+
void                cogl_material_set_specular          (CoglHandle material,
+                                                         const CoglColor *specular);

Sets the material's specular color, in the standard OpenGL lighting model. The intensity of the specular color depends on the viewport @@ -608,6 +673,8 @@

The default value is (0.0, 0.0, 0.0, 1.0)

+

+

@@ -628,10 +695,12 @@

cogl_material_get_specular ()

-
void                cogl_material_get_specular          (CoglHandle material,
-                                                         CoglColor *specular);
+
void                cogl_material_get_specular          (CoglHandle material,
+                                                         CoglColor *specular);

Retrieves the materials current specular color.

+

+

@@ -652,8 +721,8 @@

cogl_material_set_shininess ()

-
void                cogl_material_set_shininess         (CoglHandle material,
-                                                         float shininess);
+
void                cogl_material_set_shininess         (CoglHandle material,
+                                                         float shininess);

Sets the materials shininess, in the standard OpenGL lighting model, which determines how specular highlights are calculated. A higher @@ -661,6 +730,8 @@

The default value is 0.0

+

+

@@ -681,9 +752,11 @@

cogl_material_get_shininess ()

-
float               cogl_material_get_shininess         (CoglHandle material);
+
float               cogl_material_get_shininess         (CoglHandle material);

Retrieves the materials current emission color.

+

+

@@ -721,52 +794,54 @@ gives an opportunity to discard fragments based on a comparison with the incoming alpha value and a reference alpha value. The CoglMaterialAlphaFunc determines how the comparison is done.

+

+

- + - + - + - + - + - + - + - + @@ -776,10 +851,10 @@

cogl_material_set_alpha_test_function ()

-
void                cogl_material_set_alpha_test_function
-                                                        (CoglHandle material,
-                                                         CoglMaterialAlphaFunc alpha_func,
-                                                         float alpha_reference);
+
void                cogl_material_set_alpha_test_function
+                                                        (CoglHandle material,
+                                                         CoglMaterialAlphaFunc alpha_func,
+                                                         float alpha_reference);

Before a primitive is blended with the framebuffer, it goes through an alpha test stage which lets you discard fragments based on the current @@ -788,7 +863,9 @@ and which continue on to the blending stage.

-The default is COGL_MATERIAL_ALPHA_FUNC_ALWAYS

+The default is COGL_MATERIAL_ALPHA_FUNC_ALWAYS

+

+

COGL_MATERIAL_ALPHA_FUNC_NEVER

COGL_MATERIAL_ALPHA_FUNC_NEVER

Never let the fragment through.

COGL_MATERIAL_ALPHA_FUNC_LESS

COGL_MATERIAL_ALPHA_FUNC_LESS

Let the fragment through if the incoming alpha value is less than the reference alpha value

COGL_MATERIAL_ALPHA_FUNC_EQUAL

COGL_MATERIAL_ALPHA_FUNC_EQUAL

Let the fragment through if the incoming alpha value equals the reference alpha value

COGL_MATERIAL_ALPHA_FUNC_LEQUAL

COGL_MATERIAL_ALPHA_FUNC_LEQUAL

Let the fragment through if the incoming alpha value is less than or equal to the reference alpha value

COGL_MATERIAL_ALPHA_FUNC_GREATER

COGL_MATERIAL_ALPHA_FUNC_GREATER

Let the fragment through if the incoming alpha value is greater than the reference alpha value

COGL_MATERIAL_ALPHA_FUNC_NOTEQUAL

COGL_MATERIAL_ALPHA_FUNC_NOTEQUAL

Let the fragment through if the incoming alpha value does not equal the reference alpha value

COGL_MATERIAL_ALPHA_FUNC_GEQUAL

COGL_MATERIAL_ALPHA_FUNC_GEQUAL

Let the fragment through if the incoming alpha value is greater than or equal to the reference alpha value.

COGL_MATERIAL_ALPHA_FUNC_ALWAYS

COGL_MATERIAL_ALPHA_FUNC_ALWAYS

Always let the fragment through.
@@ -814,11 +891,15 @@
-

COGL_BLEND_STRING_ERROR

+

COGL_BLEND_STRING_ERROR

#define COGL_BLEND_STRING_ERROR (cogl_blend_string_error_quark ())
 

-GError domain for blend string parser errors

+GError domain for blend string parser errors

+

+

Since 1.0


@@ -833,26 +914,28 @@

Error enumeration for the blend strings parser

+

+

- + - + - + - + @@ -864,9 +947,13 @@

cogl_material_set_blend ()

-
gboolean            cogl_material_set_blend             (CoglHandle material,
-                                                         const char *blend_string,
-                                                         GError **error);
+
gboolean            cogl_material_set_blend             (CoglHandle material,
+                                                         const char *blend_string,
+                                                         GError **error);

If not already familiar; please refer here for an overview of what blend strings are, and their syntax. @@ -966,6 +1053,8 @@

That gives normal alpha-blending when the calculated color for the material is in premultiplied form.

+

+

COGL_BLEND_STRING_ERROR_PARSE_ERROR

COGL_BLEND_STRING_ERROR_PARSE_ERROR

Generic parse error

COGL_BLEND_STRING_ERROR_ARGUMENT_PARSE_ERROR

COGL_BLEND_STRING_ERROR_ARGUMENT_PARSE_ERROR

Argument parse error

COGL_BLEND_STRING_ERROR_INVALID_ERROR

COGL_BLEND_STRING_ERROR_INVALID_ERROR

Internal parser error

COGL_BLEND_STRING_ERROR_GPU_UNSUPPORTED_ERROR

COGL_BLEND_STRING_ERROR_GPU_UNSUPPORTED_ERROR

Blend string not supported by the GPU
@@ -982,19 +1071,21 @@ - - @@ -1006,11 +1097,13 @@

cogl_material_set_blend_constant ()

-
void                cogl_material_set_blend_constant    (CoglHandle material,
-                                                         CoglColor *constant_color);
+
void                cogl_material_set_blend_constant    (CoglHandle material,
+                                                         CoglColor *constant_color);

When blending is setup to reference a CONSTANT blend factor then blending will depend on the constant set with this function.

+

+

error :

return location for a GError that may report lack of driver + return location for a GError that may report lack of driver support if you give separate blend string statements for the alpha channel and RGB channels since some drivers, or backends such as - GLES 1.1, don't support this feature. May be NULL, in which case a + GLES 1.1, don't support this feature. May be NULL, in which case a warning will be printed out using GLib's logging facilities if an error is encountered.

Returns :

TRUE if the blend string was successfully parsed, and the + TRUE if the blend string was successfully parsed, and the described blending is supported by the underlying driver/hardware. If - there was an error, FALSE is returned and error is set accordingly (if + there was an error, FALSE is returned and error is set accordingly (if present).
@@ -1031,9 +1124,9 @@

cogl_material_set_layer ()

-
void                cogl_material_set_layer             (CoglHandle material,
-                                                         int layer_index,
-                                                         CoglHandle texture);
+
void                cogl_material_set_layer             (CoglHandle material,
+                                                         int layer_index,
+                                                         CoglHandle texture);

In addition to the standard OpenGL lighting model a Cogl material may have one or more layers comprised of textures that can be blended together in @@ -1049,6 +1142,8 @@

Note

In the future, we may define other types of material layers, such as purely GLSL based layers.
+

+

@@ -1074,10 +1169,12 @@

cogl_material_remove_layer ()

-
void                cogl_material_remove_layer          (CoglHandle material,
-                                                         int layer_index);
+
void                cogl_material_remove_layer          (CoglHandle material,
+                                                         int layer_index);

This function removes a layer from your material

+

+

@@ -1097,10 +1194,14 @@

cogl_material_set_layer_combine ()

-
gboolean            cogl_material_set_layer_combine     (CoglHandle material,
-                                                         int layer_index,
-                                                         const char *blend_string,
-                                                         GError **error);
+
gboolean            cogl_material_set_layer_combine     (CoglHandle material,
+                                                         int layer_index,
+                                                         const char *blend_string,
+                                                         GError **error);

If not already familiar; you can refer here for an overview of what blend @@ -1191,6 +1292,8 @@

Note

You can't give a multiplication factor for arguments as you can with blending.
+

+

@@ -1212,16 +1315,18 @@ - - @@ -1232,13 +1337,15 @@

cogl_material_set_layer_combine_constant ()

-
void                cogl_material_set_layer_combine_constant
-                                                        (CoglHandle material,
-                                                         int layer_index,
-                                                         CoglColor *constant);
+
void                cogl_material_set_layer_combine_constant
+                                                        (CoglHandle material,
+                                                         int layer_index,
+                                                         CoglColor *constant);

When you are using the 'CONSTANT' color source in a layer combine description then you can use this function to define its value.

+

+

error :

A GError that may report parse errors or lack of GPU/driver - support. May be NULL, in which case a warning will be printed out if an + A GError that may report parse errors or lack of GPU/driver + support. May be NULL, in which case a warning will be printed out if an error is encountered.

Returns :

TRUE if the blend string was successfully parsed, and the + TRUE if the blend string was successfully parsed, and the described texture combining is supported by the underlying driver and - or hardware. On failure, FALSE is returned and error is set + or hardware. On failure, FALSE is returned and error is set
@@ -1265,12 +1372,14 @@

cogl_material_set_layer_matrix ()

-
void                cogl_material_set_layer_matrix      (CoglHandle material,
-                                                         int layer_index,
-                                                         CoglMatrix *matrix);
+
void                cogl_material_set_layer_matrix      (CoglHandle material,
+                                                         int layer_index,
+                                                         CoglMatrix *matrix);

This function lets you set a matrix that can be used to e.g. translate and rotate a single layer of a material used to fill your geometry.

+

+

@@ -1295,10 +1404,14 @@

cogl_material_get_layers ()

-
const GList *       cogl_material_get_layers            (CoglHandle material);
+
const GList *       cogl_material_get_layers            (CoglHandle material);

This function lets you access a materials internal list of layers for iteration.

+

+

@@ -1309,7 +1422,7 @@ - +

Returns :

element-type Handle) (transfer none. element-type Handle. transfer none Handle. element-type Handle) (transfer none. element-type Handle. transfer none.
@@ -1317,9 +1430,11 @@

cogl_material_get_n_layers ()

-
int                 cogl_material_get_n_layers          (CoglHandle material);
+
int                 cogl_material_get_n_layers          (CoglHandle material);

Retrieves the number of layers defined for the given material

+

+

@@ -1356,48 +1471,50 @@ correspond to different strategies used to come up with a pixel color, by possibly referring to multiple neighbouring texels and taking a weighted average or simply using the nearest texel.

+

+

- + - + - + - + - + - + @@ -1407,13 +1524,15 @@

cogl_material_set_layer_filters ()

-
void                cogl_material_set_layer_filters     (CoglHandle material,
-                                                         int layer_index,
-                                                         CoglMaterialFilter min_filter,
-                                                         CoglMaterialFilter mag_filter);
+
void                cogl_material_set_layer_filters     (CoglHandle material,
+                                                         int layer_index,
+                                                         CoglMaterialFilter min_filter,
+                                                         CoglMaterialFilter mag_filter);

Changes the decimation and interpolation filters used when a texture is drawn at other scales than 100%.

+

+

COGL_MATERIAL_FILTER_NEAREST

COGL_MATERIAL_FILTER_NEAREST

Measuring in manhatten distance from the, current pixel center, use the nearest texture texel

COGL_MATERIAL_FILTER_LINEAR

COGL_MATERIAL_FILTER_LINEAR

Use the weighted average of the 4 texels nearest the current pixel center

COGL_MATERIAL_FILTER_NEAREST_MIPMAP_NEAREST

COGL_MATERIAL_FILTER_NEAREST_MIPMAP_NEAREST

Select the mimap level whose texel size most closely matches the current pixel, and use the - COGL_MATERIAL_FILTER_NEAREST criterion + COGL_MATERIAL_FILTER_NEAREST criterion

COGL_MATERIAL_FILTER_LINEAR_MIPMAP_NEAREST

COGL_MATERIAL_FILTER_LINEAR_MIPMAP_NEAREST

Select the mimap level whose texel size most closely matches the current pixel, and use the - COGL_MATERIAL_FILTER_LINEAR criterion + COGL_MATERIAL_FILTER_LINEAR criterion

COGL_MATERIAL_FILTER_NEAREST_MIPMAP_LINEAR

COGL_MATERIAL_FILTER_NEAREST_MIPMAP_LINEAR

Select the two mimap levels whose texel size most closely matches the current pixel, use - the COGL_MATERIAL_FILTER_NEAREST criterion on each one and take + the COGL_MATERIAL_FILTER_NEAREST criterion on each one and take their weighted average

COGL_MATERIAL_FILTER_LINEAR_MIPMAP_LINEAR

COGL_MATERIAL_FILTER_LINEAR_MIPMAP_LINEAR

Select the two mimap levels whose texel size most closely matches the current pixel, use - the COGL_MATERIAL_FILTER_LINEAR criterion on each one and take + the COGL_MATERIAL_FILTER_LINEAR criterion on each one and take their weighted average
@@ -1450,10 +1569,12 @@

Available types of layers for a CoglMaterial. This enumeration might be expanded in later versions.

+

+

- + @@ -1464,15 +1585,17 @@

cogl_material_layer_get_type ()

-
CoglMaterialLayerType  cogl_material_layer_get_type     (CoglHandle layer);
+
CoglMaterialLayerType  cogl_material_layer_get_type     (CoglHandle layer);

Retrieves the type of the layer

Currently there is only one type of layer defined: -COGL_MATERIAL_LAYER_TYPE_TEXTURE, but considering we may add purely GLSL +COGL_MATERIAL_LAYER_TYPE_TEXTURE, but considering we may add purely GLSL based layers in the future, you should write code that checks the type first.

+

+

COGL_MATERIAL_LAYER_TYPE_TEXTURE

COGL_MATERIAL_LAYER_TYPE_TEXTURE

The layer represents a texture
@@ -1492,7 +1615,7 @@

cogl_material_layer_get_texture ()

-
CoglHandle          cogl_material_layer_get_texture     (CoglHandle layer);
+
CoglHandle          cogl_material_layer_get_texture     (CoglHandle layer);

Extracts a texture handle for a specific layer.

@@ -1500,10 +1623,12 @@

Note

In the future Cogl may support purely GLSL based layers; for those -layers this function which will likely return COGL_INVALID_HANDLE if you +layers this function which will likely return COGL_INVALID_HANDLE if you try to get the texture handle from them. Considering this scenario, you should call cogl_material_layer_get_type() first in order check it is of -type COGL_MATERIAL_LAYER_TYPE_TEXTURE before calling this function.
+type COGL_MATERIAL_LAYER_TYPE_TEXTURE before calling this function.
+

+

@@ -1523,9 +1648,11 @@

cogl_material_layer_get_min_filter ()

-
CoglMaterialFilter  cogl_material_layer_get_min_filter  (CoglHandle layer);
+
CoglMaterialFilter  cogl_material_layer_get_min_filter  (CoglHandle layer);

Queries the currently set downscaling filter for a material layer

+

+

@@ -1545,9 +1672,11 @@

cogl_material_layer_get_mag_filter ()

-
CoglMaterialFilter  cogl_material_layer_get_mag_filter  (CoglHandle layer);
+
CoglMaterialFilter  cogl_material_layer_get_mag_filter  (CoglHandle layer);

Queries the currently set downscaling filter for a material later

+

+

@@ -1568,6 +1697,6 @@ + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/cogl/html/ch01.html +++ clutter-1.0-1.2.4/doc/reference/cogl/html/ch01.html @@ -8,7 +8,7 @@ - + @@ -29,7 +29,7 @@

-COGL - GL Abstraction API

+COGL - GL Abstraction API
About COGL
@@ -83,6 +83,6 @@
+ Generated by GTK-Doc V1.11
- \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/cogl/html/cogl-Vertex-Buffers.html +++ clutter-1.0-1.2.4/doc/reference/cogl/html/cogl-Vertex-Buffers.html @@ -8,7 +8,7 @@ - + @@ -30,8 +30,8 @@ Top -  |  - Description +  |  + Description
@@ -46,44 +46,53 @@

Synopsis

-
CoglHandle          cogl_vertex_buffer_new              (unsigned int n_vertices);
-unsigned int        cogl_vertex_buffer_get_n_vertices   (CoglHandle handle);
-CoglHandle          cogl_vertex_buffer_ref              (CoglHandle handle);
-void                cogl_vertex_buffer_unref            (CoglHandle handle);
-void                cogl_vertex_buffer_add              (CoglHandle handle,
-                                                         const char *attribute_name,
-                                                         guint8 n_components,
-                                                         CoglAttributeType type,
-                                                         gboolean normalized,
-                                                         guint16 stride,
-                                                         const void *pointer);
-void                cogl_vertex_buffer_delete           (CoglHandle handle,
-                                                         const char *attribute_name);
-void                cogl_vertex_buffer_submit           (CoglHandle handle);
-void                cogl_vertex_buffer_disable          (CoglHandle handle,
-                                                         const char *attribute_name);
-void                cogl_vertex_buffer_enable           (CoglHandle handle,
-                                                         const char *attribute_name);
+
+CoglHandle          cogl_vertex_buffer_new              (unsigned int n_vertices);
+unsigned int        cogl_vertex_buffer_get_n_vertices   (CoglHandle handle);
+CoglHandle          cogl_vertex_buffer_ref              (CoglHandle handle);
+void                cogl_vertex_buffer_unref            (CoglHandle handle);
+void                cogl_vertex_buffer_add              (CoglHandle handle,
+                                                         const char *attribute_name,
+                                                         guint8 n_components,
+                                                         CoglAttributeType type,
+                                                         gboolean normalized,
+                                                         guint16 stride,
+                                                         const void *pointer);
+void                cogl_vertex_buffer_delete           (CoglHandle handle,
+                                                         const char *attribute_name);
+void                cogl_vertex_buffer_submit           (CoglHandle handle);
+void                cogl_vertex_buffer_disable          (CoglHandle handle,
+                                                         const char *attribute_name);
+void                cogl_vertex_buffer_enable           (CoglHandle handle,
+                                                         const char *attribute_name);
 enum                CoglVerticesMode;
-void                cogl_vertex_buffer_draw             (CoglHandle handle,
-                                                         CoglVerticesMode mode,
-                                                         int first,
-                                                         int count);
-gboolean            cogl_is_vertex_buffer               (CoglHandle handle);
+void                cogl_vertex_buffer_draw             (CoglHandle handle,
+                                                         CoglVerticesMode mode,
+                                                         int first,
+                                                         int count);
+gboolean            cogl_is_vertex_buffer               (CoglHandle handle);
 
 enum                CoglIndicesType;
-CoglHandle          cogl_vertex_buffer_indices_new      (CoglIndicesType indices_type,
-                                                         const void *indices_array,
-                                                         int indices_len);
-void                cogl_vertex_buffer_draw_elements    (CoglHandle handle,
-                                                         CoglVerticesMode mode,
-                                                         CoglHandle indices,
-                                                         int min_index,
-                                                         int max_index,
-                                                         int indices_offset,
-                                                         int count);
-CoglHandle          cogl_vertex_buffer_indices_get_for_quads
-                                                        (unsigned int n_indices);
+CoglHandle          cogl_vertex_buffer_indices_new      (CoglIndicesType indices_type,
+                                                         const void *indices_array,
+                                                         int indices_len);
+void                cogl_vertex_buffer_draw_elements    (CoglHandle handle,
+                                                         CoglVerticesMode mode,
+                                                         CoglHandle indices,
+                                                         int min_index,
+                                                         int max_index,
+                                                         int indices_offset,
+                                                         int count);
+CoglHandle          cogl_vertex_buffer_indices_get_for_quads
+                                                        (unsigned int n_indices);
 
@@ -125,14 +134,18 @@ and if you do need to repeatedly update attributes (e.g. for some kind of morphing geometry) then only update and re-submit the specific attributes that have changed.

+

+

Details

cogl_vertex_buffer_new ()

-
CoglHandle          cogl_vertex_buffer_new              (unsigned int n_vertices);
+
CoglHandle          cogl_vertex_buffer_new              (unsigned int n_vertices);

Creates a new vertex buffer that you can use to add attributes.

+

+

@@ -152,9 +165,11 @@

cogl_vertex_buffer_get_n_vertices ()

-
unsigned int        cogl_vertex_buffer_get_n_vertices   (CoglHandle handle);
+
unsigned int        cogl_vertex_buffer_get_n_vertices   (CoglHandle handle);

Retrieves the number of vertices that handle represents

+

+

@@ -174,13 +189,15 @@

cogl_vertex_buffer_ref ()

-
CoglHandle          cogl_vertex_buffer_ref              (CoglHandle handle);
+
CoglHandle          cogl_vertex_buffer_ref              (CoglHandle handle);

Warning

cogl_vertex_buffer_ref has been deprecated since version 1.2 and should not be used in newly-written code. Use cogl_handle_ref() instead

Increment the reference count for a vertex buffer

+

+

@@ -201,13 +218,15 @@

cogl_vertex_buffer_unref ()

-
void                cogl_vertex_buffer_unref            (CoglHandle handle);
+
void                cogl_vertex_buffer_unref            (CoglHandle handle);

Warning

cogl_vertex_buffer_unref has been deprecated since version 1.2 and should not be used in newly-written code. Use cogl_handle_unref() instead

Decrement the reference count for a vertex buffer

+

+

@@ -220,13 +239,19 @@

cogl_vertex_buffer_add ()

-
void                cogl_vertex_buffer_add              (CoglHandle handle,
-                                                         const char *attribute_name,
-                                                         guint8 n_components,
-                                                         CoglAttributeType type,
-                                                         gboolean normalized,
-                                                         guint16 stride,
-                                                         const void *pointer);
+
void                cogl_vertex_buffer_add              (CoglHandle handle,
+                                                         const char *attribute_name,
+                                                         guint8 n_components,
+                                                         CoglAttributeType type,
+                                                         gboolean normalized,
+                                                         guint16 stride,
+                                                         const void *pointer);

Adds an attribute to a buffer.

@@ -263,6 +288,8 @@ |- - - - -0-0-0-0-0-0 0 0 0 0| (Though you can have multiple groups of interleved attributes)
+

+

@@ -300,9 +327,9 @@ - @@ -329,12 +356,14 @@

cogl_vertex_buffer_delete ()

-
void                cogl_vertex_buffer_delete           (CoglHandle handle,
-                                                         const char *attribute_name);
+
void                cogl_vertex_buffer_delete           (CoglHandle handle,
+                                                         const char *attribute_name);

Deletes an attribute from a buffer. You will need to call cogl_vertex_buffer_submit() or issue a draw call to commit this change to the GPU.

+

+

normalized :

If TRUE, this specifies that values stored in an integer + If TRUE, this specifies that values stored in an integer format should be mapped into the range [-1.0, 1.0] or [0.0, 1.0] - for unsigned values. If FALSE they are converted to floats + for unsigned values. If FALSE they are converted to floats directly.
@@ -354,7 +383,7 @@

cogl_vertex_buffer_submit ()

-
void                cogl_vertex_buffer_submit           (CoglHandle handle);
+
void                cogl_vertex_buffer_submit           (CoglHandle handle);

Submits all the user added attributes to the GPU; once submitted, the attributes can be used for drawing. @@ -364,6 +393,8 @@ validating your data; it potentially incurs a transport cost (especially if you are using GLX indirect rendering) and potentially a format conversion cost if the GPU doesn't natively support any of the given attribute formats.

+

+

@@ -376,8 +407,8 @@

cogl_vertex_buffer_disable ()

-
void                cogl_vertex_buffer_disable          (CoglHandle handle,
-                                                         const char *attribute_name);
+
void                cogl_vertex_buffer_disable          (CoglHandle handle,
+                                                         const char *attribute_name);

Disables a previosuly added attribute.

@@ -389,6 +420,8 @@

You don't need to call cogl_vertex_buffer_submit() after using this function.

+

+

@@ -408,8 +441,8 @@

cogl_vertex_buffer_enable ()

-
void                cogl_vertex_buffer_enable           (CoglHandle handle,
-                                                         const char *attribute_name);
+
void                cogl_vertex_buffer_enable           (CoglHandle handle,
+                                                         const char *attribute_name);

Enables a previosuly disabled attribute.

@@ -420,6 +453,8 @@

You don't need to call cogl_vertex_buffer_submit() after using this function

+

+

@@ -452,41 +487,43 @@

How vertices passed to cogl_vertex_buffer_draw() and cogl_vertex_buffer_draw_elements() should be interpreted

+

+

- + - + - + - + - + - + - + @@ -497,10 +534,10 @@

cogl_vertex_buffer_draw ()

-
void                cogl_vertex_buffer_draw             (CoglHandle handle,
-                                                         CoglVerticesMode mode,
-                                                         int first,
-                                                         int count);
+
void                cogl_vertex_buffer_draw             (CoglHandle handle,
+                                                         CoglVerticesMode mode,
+                                                         int first,
+                                                         int count);

Allows you to draw geometry using all or a subset of the vertices in a vertex buffer. @@ -508,6 +545,8 @@

Any un-submitted attribute changes are automatically submitted before drawing.

+

+

COGL_VERTICES_MODE_POINTS

COGL_VERTICES_MODE_POINTS

FIXME, equivalent to GL_POINTS

COGL_VERTICES_MODE_LINE_STRIP

COGL_VERTICES_MODE_LINE_STRIP

FIXME, equivalent to GL_LINE_STRIP

COGL_VERTICES_MODE_LINE_LOOP

COGL_VERTICES_MODE_LINE_LOOP

FIXME, equivalent to GL_LINE_LOOP

COGL_VERTICES_MODE_LINES

COGL_VERTICES_MODE_LINES

FIXME, equivalent to GL_LINES

COGL_VERTICES_MODE_TRIANGLE_STRIP

COGL_VERTICES_MODE_TRIANGLE_STRIP

FIXME, equivalent to GL_TRIANGLE_STRIP

COGL_VERTICES_MODE_TRIANGLE_FAN

COGL_VERTICES_MODE_TRIANGLE_FAN

FIXME, equivalent to GL_TRIANGLE_FAN

COGL_VERTICES_MODE_TRIANGLES

COGL_VERTICES_MODE_TRIANGLES

FIXME, equivalent to GL_TRIANGLES
@@ -538,9 +577,13 @@

cogl_is_vertex_buffer ()

-
gboolean            cogl_is_vertex_buffer               (CoglHandle handle);
+
gboolean            cogl_is_vertex_buffer               (CoglHandle handle);

Checks whether handle is a Vertex Buffer Object

+

+

@@ -551,7 +594,7 @@ - @@ -575,26 +618,28 @@ reduce the demand on memory bandwidth.

-Note that COGL_INDICES_TYPE_UNSIGNED_INT is only supported if the -COGL_FEATURE_UNSIGNED_INT_INDICES feature is available. This +Note that COGL_INDICES_TYPE_UNSIGNED_INT is only supported if the +COGL_FEATURE_UNSIGNED_INT_INDICES feature is available. This should always be available on OpenGL but on OpenGL ES it will only be available if the GL_OES_element_index_uint extension is advertized.

+

+

Returns :

TRUE if the handle is a VBO, and FALSE + TRUE if the handle is a VBO, and FALSE otherwise
- + - + - + @@ -604,14 +649,16 @@

cogl_vertex_buffer_indices_new ()

-
CoglHandle          cogl_vertex_buffer_indices_new      (CoglIndicesType indices_type,
-                                                         const void *indices_array,
-                                                         int indices_len);
+
CoglHandle          cogl_vertex_buffer_indices_new      (CoglIndicesType indices_type,
+                                                         const void *indices_array,
+                                                         int indices_len);

Depending on how much geometry you are submitting it can be worthwhile optimizing the number of redundant vertices you submit. Using an index array allows you to reference vertices multiple times, for example during triangle strips.

+

+

COGL_INDICES_TYPE_UNSIGNED_BYTE

COGL_INDICES_TYPE_UNSIGNED_BYTE

Your indices are unsigned bytes

COGL_INDICES_TYPE_UNSIGNED_SHORT

COGL_INDICES_TYPE_UNSIGNED_SHORT

Your indices are unsigned shorts

COGL_INDICES_TYPE_UNSIGNED_INT

COGL_INDICES_TYPE_UNSIGNED_INT

Your indices are unsigned ints
@@ -642,13 +689,13 @@

cogl_vertex_buffer_draw_elements ()

-
void                cogl_vertex_buffer_draw_elements    (CoglHandle handle,
-                                                         CoglVerticesMode mode,
-                                                         CoglHandle indices,
-                                                         int min_index,
-                                                         int max_index,
-                                                         int indices_offset,
-                                                         int count);
+
void                cogl_vertex_buffer_draw_elements    (CoglHandle handle,
+                                                         CoglVerticesMode mode,
+                                                         CoglHandle indices,
+                                                         int min_index,
+                                                         int max_index,
+                                                         int indices_offset,
+                                                         int count);

This function lets you use an array of indices to specify the vertices within your vertex buffer that you want to draw. The indices themselves @@ -657,6 +704,8 @@

Any un-submitted attribute changes are automatically submitted before drawing.

+

+

@@ -704,8 +753,8 @@

cogl_vertex_buffer_indices_get_for_quads ()

-
CoglHandle          cogl_vertex_buffer_indices_get_for_quads
-                                                        (unsigned int n_indices);
+
CoglHandle          cogl_vertex_buffer_indices_get_for_quads
+                                                        (unsigned int n_indices);

Creates a vertex buffer containing the indices needed to draw pairs of triangles from a list of vertices grouped as quads. There will @@ -746,6 +795,8 @@ ######## ## 1 2 2

+

+

@@ -767,6 +818,6 @@ + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/cogl/html/cogl-Color-Type.html +++ clutter-1.0-1.2.4/doc/reference/cogl/html/cogl-Color-Type.html @@ -8,7 +8,7 @@ - + @@ -30,8 +30,8 @@
Top -  |  - Description +  |  + Description
@@ -45,39 +45,54 @@

Synopsis

-
                    CoglColor;
-CoglColor *         cogl_color_new                      (void);
-CoglColor *         cogl_color_copy                     (const CoglColor *color);
-void                cogl_color_free                     (CoglColor *color);
-void                cogl_color_set_from_4ub             (CoglColor *dest,
-                                                         guint8 red,
-                                                         guint8 green,
-                                                         guint8 blue,
-                                                         guint8 alpha);
-void                cogl_color_set_from_4f              (CoglColor *dest,
-                                                         float red,
-                                                         float green,
-                                                         float blue,
-                                                         float alpha);
-
-float               cogl_color_get_red                  (const CoglColor *color);
-float               cogl_color_get_green                (const CoglColor *color);
-float               cogl_color_get_blue                 (const CoglColor *color);
-float               cogl_color_get_alpha                (const CoglColor *color);
-
-unsigned char       cogl_color_get_red_byte             (const CoglColor *color);
-unsigned char       cogl_color_get_green_byte           (const CoglColor *color);
-unsigned char       cogl_color_get_blue_byte            (const CoglColor *color);
-unsigned char       cogl_color_get_alpha_byte           (const CoglColor *color);
-
-float               cogl_color_get_red_float            (const CoglColor *color);
-float               cogl_color_get_green_float          (const CoglColor *color);
-float               cogl_color_get_blue_float           (const CoglColor *color);
-float               cogl_color_get_alpha_float          (const CoglColor *color);
-
-void                cogl_color_premultiply              (CoglColor *color);
-gboolean            cogl_color_equal                    (gconstpointer v1,
-                                                         gconstpointer v2);
+
+                    CoglColor;
+CoglColor *         cogl_color_new                      (void);
+CoglColor *         cogl_color_copy                     (const CoglColor *color);
+void                cogl_color_free                     (CoglColor *color);
+void                cogl_color_set_from_4ub             (CoglColor *dest,
+                                                         guint8 red,
+                                                         guint8 green,
+                                                         guint8 blue,
+                                                         guint8 alpha);
+void                cogl_color_set_from_4f              (CoglColor *dest,
+                                                         float red,
+                                                         float green,
+                                                         float blue,
+                                                         float alpha);
+
+float               cogl_color_get_red                  (const CoglColor *color);
+float               cogl_color_get_green                (const CoglColor *color);
+float               cogl_color_get_blue                 (const CoglColor *color);
+float               cogl_color_get_alpha                (const CoglColor *color);
+
+unsigned char       cogl_color_get_red_byte             (const CoglColor *color);
+unsigned char       cogl_color_get_green_byte           (const CoglColor *color);
+unsigned char       cogl_color_get_blue_byte            (const CoglColor *color);
+unsigned char       cogl_color_get_alpha_byte           (const CoglColor *color);
+
+float               cogl_color_get_red_float            (const CoglColor *color);
+float               cogl_color_get_green_float          (const CoglColor *color);
+float               cogl_color_get_blue_float           (const CoglColor *color);
+float               cogl_color_get_alpha_float          (const CoglColor *color);
+
+void                cogl_color_premultiply              (CoglColor *color);
+gboolean            cogl_color_equal                    (gconstpointer v1,
+                                                         gconstpointer v2);
 
@@ -85,6 +100,8 @@

CoglColor is a simple structure holding the definition of a color such that it can be efficiently used by GL

+

+

Details

@@ -97,14 +114,18 @@ A structure for holding a color definition. The contents of the CoglColor structure are private and should never by accessed directly.

+

+

Since 1.0


cogl_color_new ()

-
CoglColor *         cogl_color_new                      (void);
+
CoglColor *         cogl_color_new                      (void);

Creates a new (empty) color

+

+

@@ -120,9 +141,11 @@

cogl_color_copy ()

-
CoglColor *         cogl_color_copy                     (const CoglColor *color);
+
CoglColor *         cogl_color_copy                     (const CoglColor *color);

Creates a copy of color

+

+

@@ -145,9 +168,11 @@

cogl_color_free ()

-
void                cogl_color_free                     (CoglColor *color);
+
void                cogl_color_free                     (CoglColor *color);

Frees the resources allocated by cogl_color_new() and cogl_color_copy()

+

+

@@ -161,13 +186,23 @@

cogl_color_set_from_4ub ()

-
void                cogl_color_set_from_4ub             (CoglColor *dest,
-                                                         guint8 red,
-                                                         guint8 green,
-                                                         guint8 blue,
-                                                         guint8 alpha);
+
void                cogl_color_set_from_4ub             (CoglColor *dest,
+                                                         guint8 red,
+                                                         guint8 green,
+                                                         guint8 blue,
+                                                         guint8 alpha);

Sets the values of the passed channels into a CoglColor.

+

+

@@ -203,13 +238,15 @@

cogl_color_set_from_4f ()

-
void                cogl_color_set_from_4f              (CoglColor *dest,
-                                                         float red,
-                                                         float green,
-                                                         float blue,
-                                                         float alpha);
+
void                cogl_color_set_from_4f              (CoglColor *dest,
+                                                         float red,
+                                                         float green,
+                                                         float blue,
+                                                         float alpha);

Sets the values of the passed channels into a CoglColor

+

+

@@ -245,10 +282,12 @@

cogl_color_get_red ()

-
float               cogl_color_get_red                  (const CoglColor *color);
+
float               cogl_color_get_red                  (const CoglColor *color);

Retrieves the red channel of color as a fixed point value between 0 and 1.0.

+

+

@@ -270,10 +309,12 @@

cogl_color_get_green ()

-
float               cogl_color_get_green                (const CoglColor *color);
+
float               cogl_color_get_green                (const CoglColor *color);

Retrieves the green channel of color as a fixed point value between 0 and 1.0.

+

+

@@ -295,10 +336,12 @@

cogl_color_get_blue ()

-
float               cogl_color_get_blue                 (const CoglColor *color);
+
float               cogl_color_get_blue                 (const CoglColor *color);

Retrieves the blue channel of color as a fixed point value between 0 and 1.0.

+

+

@@ -320,10 +363,12 @@

cogl_color_get_alpha ()

-
float               cogl_color_get_alpha                (const CoglColor *color);
+
float               cogl_color_get_alpha                (const CoglColor *color);

Retrieves the alpha channel of color as a fixed point value between 0 and 1.0.

+

+

@@ -345,10 +390,12 @@

cogl_color_get_red_byte ()

-
unsigned char       cogl_color_get_red_byte             (const CoglColor *color);
+
unsigned char       cogl_color_get_red_byte             (const CoglColor *color);

Retrieves the red channel of color as a byte value between 0 and 255

+

+

@@ -370,10 +417,12 @@

cogl_color_get_green_byte ()

-
unsigned char       cogl_color_get_green_byte           (const CoglColor *color);
+
unsigned char       cogl_color_get_green_byte           (const CoglColor *color);

Retrieves the green channel of color as a byte value between 0 and 255

+

+

@@ -395,10 +444,12 @@

cogl_color_get_blue_byte ()

-
unsigned char       cogl_color_get_blue_byte            (const CoglColor *color);
+
unsigned char       cogl_color_get_blue_byte            (const CoglColor *color);

Retrieves the blue channel of color as a byte value between 0 and 255

+

+

@@ -420,10 +471,12 @@

cogl_color_get_alpha_byte ()

-
unsigned char       cogl_color_get_alpha_byte           (const CoglColor *color);
+
unsigned char       cogl_color_get_alpha_byte           (const CoglColor *color);

Retrieves the alpha channel of color as a byte value between 0 and 255

+

+

@@ -445,10 +498,12 @@

cogl_color_get_red_float ()

-
float               cogl_color_get_red_float            (const CoglColor *color);
+
float               cogl_color_get_red_float            (const CoglColor *color);

Retrieves the red channel of color as a floating point value between 0.0 and 1.0

+

+

@@ -470,10 +525,12 @@

cogl_color_get_green_float ()

-
float               cogl_color_get_green_float          (const CoglColor *color);
+
float               cogl_color_get_green_float          (const CoglColor *color);

Retrieves the green channel of color as a floating point value between 0.0 and 1.0

+

+

@@ -495,10 +552,12 @@

cogl_color_get_blue_float ()

-
float               cogl_color_get_blue_float           (const CoglColor *color);
+
float               cogl_color_get_blue_float           (const CoglColor *color);

Retrieves the blue channel of color as a floating point value between 0.0 and 1.0

+

+

@@ -520,10 +579,12 @@

cogl_color_get_alpha_float ()

-
float               cogl_color_get_alpha_float          (const CoglColor *color);
+
float               cogl_color_get_alpha_float          (const CoglColor *color);

Retrieves the alpha channel of color as a floating point value between 0.0 and 1.0

+

+

@@ -545,11 +606,13 @@

cogl_color_premultiply ()

-
void                cogl_color_premultiply              (CoglColor *color);
+
void                cogl_color_premultiply              (CoglColor *color);

Converts a non-premultiplied color to a pre-multiplied color. For example, semi-transparent red is (1.0, 0, 0, 0.5) when non-premultiplied and (0.5, 0, 0, 0.5) when premultiplied.

+

+

@@ -563,14 +626,26 @@

cogl_color_equal ()

-
gboolean            cogl_color_equal                    (gconstpointer v1,
-                                                         gconstpointer v2);
+
gboolean            cogl_color_equal                    (gconstpointer v1,
+                                                         gconstpointer v2);

Compares two CoglColors 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 CoglColors as keys in a GHashTable.

+This function can be passed to g_hash_table_new() as the key_equal_func +parameter, when using CoglColors as keys in a GHashTable.

+

+

@@ -586,7 +661,7 @@ - @@ -598,6 +673,6 @@ + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/cogl/html/cogl-Clipping.html +++ clutter-1.0-1.2.4/doc/reference/cogl/html/cogl-Clipping.html @@ -8,7 +8,7 @@ - + @@ -30,8 +30,8 @@

Returns :

TRUE if the two colors are the same. + TRUE if the two colors are the same.
Top -  |  - Description +  |  + Description
@@ -45,29 +45,30 @@

Synopsis

-
void                cogl_clip_push_rectangle            (float x0,
-                                                         float y0,
-                                                         float x1,
-                                                         float y1);
-void                cogl_clip_push_window_rectangle     (int x_offset,
-                                                         int y_offset,
-                                                         int width,
-                                                         int height);
-void                cogl_clip_push_from_path            (void);
-void                cogl_clip_push_from_path_preserve   (void);
-void                cogl_clip_pop                       (void);
+
+void                cogl_clip_push_rectangle            (float x0,
+                                                         float y0,
+                                                         float x1,
+                                                         float y1);
+void                cogl_clip_push_window_rectangle     (int x_offset,
+                                                         int y_offset,
+                                                         int width,
+                                                         int height);
+void                cogl_clip_push_from_path            (void);
+void                cogl_clip_push_from_path_preserve   (void);
+void                cogl_clip_pop                       (void);
 
-void                cogl_clip_push                      (float x_offset,
-                                                         float y_offset,
-                                                         float width,
-                                                         float height);
-void                cogl_clip_push_window_rect          (float x_offset,
-                                                         float y_offset,
-                                                         float width,
-                                                         float height);
-void                cogl_clip_ensure                    (void);
-void                cogl_clip_stack_save                (void);
-void                cogl_clip_stack_restore             (void);
+void                cogl_clip_push                      (float x_offset,
+                                                         float y_offset,
+                                                         float width,
+                                                         float height);
+void                cogl_clip_push_window_rect          (float x_offset,
+                                                         float y_offset,
+                                                         float width,
+                                                         float height);
+void                cogl_clip_ensure                    (void);
+void                cogl_clip_stack_save                (void);
+void                cogl_clip_stack_restore             (void);
 
@@ -76,15 +77,17 @@ To support clipping your geometry to rectangles or paths Cogl exposes a stack based API whereby each clip region you push onto the stack is intersected with the previous region.

+

+

Details

cogl_clip_push_rectangle ()

-
void                cogl_clip_push_rectangle            (float x0,
-                                                         float y0,
-                                                         float x1,
-                                                         float y1);
+
void                cogl_clip_push_rectangle            (float x0,
+                                                         float y0,
+                                                         float x1,
+                                                         float y1);

Specifies a rectangular clipping area for all subsequent drawing operations. Any drawing commands that extend outside the rectangle @@ -95,6 +98,8 @@

The rectangle is intersected with the current clip region. To undo the effect of this function, call cogl_clip_pop().

+

+

@@ -125,10 +130,10 @@

cogl_clip_push_window_rectangle ()

-
void                cogl_clip_push_window_rectangle     (int x_offset,
-                                                         int y_offset,
-                                                         int width,
-                                                         int height);
+
void                cogl_clip_push_window_rectangle     (int x_offset,
+                                                         int y_offset,
+                                                         int width,
+                                                         int height);

Specifies a rectangular clipping area for all subsequent drawing operations. Any drawing commands that extend outside the rectangle @@ -139,6 +144,8 @@

The rectangle is intersected with the current clip region. To undo the effect of this function, call cogl_clip_pop().

+

+

@@ -169,40 +176,46 @@

cogl_clip_push_from_path ()

-
void                cogl_clip_push_from_path            (void);
+
void                cogl_clip_push_from_path            (void);

Sets a new clipping area using the current path. The current path is then cleared. The clipping area is intersected with the previous clipping area. To restore the previous clipping area, call cogl_clip_pop().

+

+

Since 1.0


cogl_clip_push_from_path_preserve ()

-
void                cogl_clip_push_from_path_preserve   (void);
+
void                cogl_clip_push_from_path_preserve   (void);

Sets a new clipping area using the current path. The current path is then cleared. The clipping area is intersected with the previous clipping area. To restore the previous clipping area, call cogl_clip_pop().

+

+

Since 1.0


cogl_clip_pop ()

-
void                cogl_clip_pop                       (void);
+
void                cogl_clip_pop                       (void);

Reverts the clipping region to the state before the last call to cogl_clip_push().

+

+


cogl_clip_push ()

-
void                cogl_clip_push                      (float x_offset,
-                                                         float y_offset,
-                                                         float width,
-                                                         float height);
+
void                cogl_clip_push                      (float x_offset,
+                                                         float y_offset,
+                                                         float width,
+                                                         float height);

Warning

cogl_clip_push has been deprecated since version 1.2 and should not be used in newly-written code. The x, y, width, height arguments are inconsistent @@ -221,6 +234,8 @@

The rectangle is intersected with the current clip region. To undo the effect of this function, call cogl_clip_pop().

+

+

@@ -250,10 +265,10 @@

cogl_clip_push_window_rect ()

-
void                cogl_clip_push_window_rect          (float x_offset,
-                                                         float y_offset,
-                                                         float width,
-                                                         float height);
+
void                cogl_clip_push_window_rect          (float x_offset,
+                                                         float y_offset,
+                                                         float width,
+                                                         float height);

Warning

cogl_clip_push_window_rect has been deprecated since version 1.2 and should not be used in newly-written code. Use cogl_clip_push_window_rectangle() instead

@@ -268,6 +283,8 @@

The rectangle is intersected with the current clip region. To undo the effect of this function, call cogl_clip_pop().

+

+

@@ -297,7 +314,7 @@

cogl_clip_ensure ()

-
void                cogl_clip_ensure                    (void);
+
void                cogl_clip_ensure                    (void);

Warning

cogl_clip_ensure has been deprecated since version 1.2 and should not be used in newly-written code. Calling this function has no effect

@@ -307,12 +324,14 @@ will automatically be called before any Cogl primitives but it maybe be neccessary to call if you are using raw GL calls with clipping.

+

+

Since 1.0


cogl_clip_stack_save ()

-
void                cogl_clip_stack_save                (void);
+
void                cogl_clip_stack_save                (void);

Warning

cogl_clip_stack_save has been deprecated since version 1.2 and should not be used in newly-written code. This was originally added to allow us to save the @@ -327,12 +346,14 @@ cogl_clip_stack_restore(). Each call to cogl_clip_push() after this must be matched by a call to cogl_clip_pop() before calling cogl_clip_stack_restore().

+

+

Since 0.8.2


cogl_clip_stack_restore ()

-
void                cogl_clip_stack_restore             (void);
+
void                cogl_clip_stack_restore             (void);

Warning

cogl_clip_stack_restore has been deprecated since version 1.2 and should not be used in newly-written code. This was originally added to allow us to restore @@ -344,12 +365,14 @@

Restore the state of the clipping stack that was previously saved by cogl_clip_stack_save().

+

+

Since 0.8.2

+ Generated by GTK-Doc V1.11
- \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/cogl/html/cogl.devhelp2 +++ clutter-1.0-1.2.4/doc/reference/cogl/html/cogl.devhelp2 @@ -29,7 +29,7 @@ - + @@ -140,7 +140,7 @@ - + @@ -257,50 +257,65 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -317,93 +332,93 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + --- clutter-1.0-1.2.4.orig/doc/reference/cogl/html/style.css +++ clutter-1.0-1.2.4/doc/reference/cogl/html/style.css @@ -1,15 +1,13 @@ .synopsis, .classsynopsis { - /* tango:aluminium 1/2 */ - background: #eeeeec; - border: solid 1px #d3d7cf; + background: #eeeeee; + border: solid 1px #aaaaaa; padding: 0.5em; } .programlisting { - /* tango:sky blue 0/1 */ - background: #e6f3ff; - border: solid 1px #729fcf; + background: #eeeeff; + border: solid 1px #aaaaff; padding: 0.5em; } .variablelist @@ -22,63 +20,64 @@ vertical-align: top; } +/* this is needed so that the local anchors are displayed below the naviagtion */ @media screen { sup a.footnote { position: relative; top: 0em ! important; - } - /* this is needed so that the local anchors are displayed below the naviagtion */ - div.footnote a[name], div.refnamediv a[name], div.refsect1 a[name], div.refsect2 a[name], div.index a[name], div.glossary a[name], div.sect1 a[name] + div.refnamediv a[name], div.refsect1 a[name] { position: relative; - padding-top:4.5em; + top: -4.5em; } - /* this seems to be a bug in the xsl style sheets when generating indexes */ - div.index div.index - { - top: 0em; - } - /* make space for the fixed navigation bar and add space at the bottom so that - * link targets appear somewhat close to top - */ - body - { - padding-top: 3.2em; - padding-bottom: 20em; - } - /* style and size the navigation bar */ table.navigation#top { - position: fixed; - /* tango:scarlet red 0/1 */ - background: #ffe6e6; - border: solid 1px #ef2929; + background: #ffeeee; + border: solid 1px #ffaaaa; margin-top: 0; margin-bottom: 0; + position: fixed; top: 0; left: 0; - height: 3em; - z-index: 10; + height: 2em; + z-index: 1; } - .navigation a, .navigation a:visited + .navigation a { - /* tango:scarlet red 3 */ - color: #a40000; + color: #770000; } - .navigation a:hover + .navigation a:visited { - /* tango:scarlet red 1 */ - color: #ef2929; + color: #550000; } td.shortcuts { - /* tango:scarlet red 1 */ - color: #ef2929; + color: #770000; font-size: 80%; white-space: nowrap; } + div.refentry, div.chapter, div.reference, div.part, div.book, div.glossary, div.sect1, div.appendix, div.preface + { + position: relative; + top: 3em; + z-index: 0; + } + div.glossary, div.index + { + position: relative; + top: 2em; + z-index: 0; + } + div.refnamediv + { + margin-top: 2em; + } + body + { + padding-bottom: 20em; + } } @media print { table.navigation { @@ -88,14 +87,13 @@ div.titlepage table.navigation { visibility: visible; display: table; - /* tango:scarlet red 0/1 */ - background: #ffe6e6; - border: solid 1px #ef2929; + background: #ffeeee; + border: solid 1px #ffaaaa; margin-top: 0; margin-bottom: 0; top: 0; left: 0; - height: 3em; + height: 2em; } } @@ -104,6 +102,7 @@ font-size: 200%; } + div.gallery-float { float: left; @@ -117,48 +116,44 @@ { clear: both; } - -a, a:visited +a { text-decoration: none; - /* tango:sky blue 2 */ - color: #3465a4; } a:hover { text-decoration: underline; - /* tango:sky blue 1 */ - color: #729fcf; + color: #FF0000; } div.table table { border-collapse: collapse; border-spacing: 0px; - /* tango:aluminium 3 */ - border: solid 1px #babdb6; + border-style: solid; + border-color: #777777; + border-width: 1px; } div.table table td, div.table table th { - /* tango:aluminium 3 */ - border: solid 1px #babdb6; + border-style: solid; + border-color: #777777; + border-width: 1px; padding: 3px; vertical-align: top; } div.table table th { - /* tango:aluminium 2 */ - background-color: #d3d7cf; + background-color: #eeeeee; } hr { - /* tango:aluminium 3 */ - color: #babdb6; - background: #babdb6; - border: none 0px; + color: #777777; + background: #777777; + border: 0; height: 1px; clear: both; } @@ -166,92 +161,7 @@ .footer { padding-top: 3.5em; - /* tango:aluminium 3 */ - color: #babdb6; + color: #777777; text-align: center; font-size: 80%; } - -.warning -{ - /* tango:orange 0/1 */ - background: #ffeed9; - border-color: #ffb04f; -} -.note -{ - /* tango:chameleon 0/0.5 */ - background: #d8ffb2; - border-color: #abf562; -} -.note, .warning -{ - padding: 0.5em; - border-width: 1px; - border-style: solid; -} -.note h3, .warning h3 -{ - margin-top: 0.0em -} -.note p, .warning p -{ - margin-bottom: 0.0em -} - -/* blob links */ -h2 .extralinks, h3 .extralinks -{ - float: right; - /* tango:aluminium 3 */ - color: #babdb6; - font-size: 80%; - font-weight: normal; -} - -/* code listings */ - -.programlisting .cbracket { color: #a40000; } /* tango: scarlet red 3 */ -.programlisting .comment { color: #a1a39d; } /* tango: aluminium 4 */ -.programlisting .function { color: #000000; font-weight: bold; } -.programlisting .function a { color: #11326b; font-weight: bold; } /* tango: sky blue 4 */ -.programlisting .keyword { color: #4e9a06; } /* tango: chameleon 3 */ -.programlisting .linenum { color: #babdb6; } /* tango: aluminium 3 */ -.programlisting .normal { color: #000000; } -.programlisting .number { color: #75507b; } /* tango: plum 2 */ -.programlisting .preproc { color: #204a87; } /* tango: sky blue 3 */ -.programlisting .string { color: #c17d11; } /* tango: chocolate 2 */ -.programlisting .type { color: #000000; } -.programlisting .type a { color: #11326b; } /* tango: sky blue 4 */ -.programlisting .symbol { color: #ce5c00; } /* tango: orange 3 */ - -.listing_frame { - /* tango:sky blue 1 */ - border: solid 1px #729fcf; - padding: 0px; -} - -.listing_lines, .listing_code { - margin-top: 0px; - margin-bottom: 0px; - padding: 0.5em; -} -.listing_lines { - /* tango:sky blue 0.5 */ - background: #a6c5e3; - /* tango:aluminium 6 */ - color: #2e3436; -} -.listing_code { - /* tango:sky blue 0 */ - background: #e6f3ff; -} -.listing_code .programlisting { - /* override from previous */ - border: none 0px; - padding: 0px; -} -.listing_lines pre, .listing_code pre { - margin: 0px; -} - --- clutter-1.0-1.2.4.orig/doc/reference/cogl/html/ix03.html +++ clutter-1.0-1.2.4/doc/reference/cogl/html/ix03.html @@ -8,7 +8,7 @@ - + @@ -20,42 +20,48 @@ -
- + - - - +

-Index of new symbols in 0.8

-

B

+Index of new symbols in 0.8
+
+
+

B

+
CoglBufferTarget
-

F

+
+
+
+

F

+
CoglFeatureFlags
-

G

+
+
+
+

G

+
cogl_get_features
-

P

+
+
+
+

P

+
CoglPixelFormat
-

T

+
+
+ +
+
+ Generated by GTK-Doc V1.11
- \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/cogl/html/cogl-Offscreen-Buffers.html +++ clutter-1.0-1.2.4/doc/reference/cogl/html/cogl-Offscreen-Buffers.html @@ -8,7 +8,7 @@ - + @@ -30,8 +30,8 @@ Top -  |  - Description +  |  + Description
@@ -46,29 +46,34 @@

Description

Cogl allows creating and operating on offscreen framebuffers.

+

+

Details

cogl_offscreen_new_to_texture ()

-
CoglHandle          cogl_offscreen_new_to_texture       (CoglHandle handle);
+
CoglHandle          cogl_offscreen_new_to_texture       (CoglHandle handle);

This creates an offscreen buffer object using the given texture as the primary color buffer. It doesn't just initialize the contents of the @@ -79,6 +84,8 @@

Note: This does not work with sliced Cogl textures.

+

+

@@ -89,7 +96,7 @@ - @@ -99,13 +106,15 @@

cogl_offscreen_ref ()

-
CoglHandle          cogl_offscreen_ref                  (CoglHandle handle);
+
CoglHandle          cogl_offscreen_ref                  (CoglHandle handle);

Warning

cogl_offscreen_ref has been deprecated since version 1.2 and should not be used in newly-written code. cogl_handle_ref should be used in new code.

Increments the reference count on the offscreen buffer.

+

+

Returns :

a CoglHandle for the new offscreen buffer or COGL_INVALID_HANDLE + a CoglHandle for the new offscreen buffer or COGL_INVALID_HANDLE if it wasn't possible to create the buffer.
@@ -126,7 +135,7 @@

cogl_offscreen_unref ()

-
void                cogl_offscreen_unref                (CoglHandle handle);
+
void                cogl_offscreen_unref                (CoglHandle handle);

Warning

cogl_offscreen_unref has been deprecated since version 1.2 and should not be used in newly-written code. cogl_handle_unref should be used in new code.

@@ -134,6 +143,8 @@

Decreases the reference count for the offscreen buffer and frees it when the count reaches 0.

+

+

@@ -146,10 +157,14 @@

cogl_is_offscreen ()

-
gboolean            cogl_is_offscreen                   (CoglHandle handle);
+
gboolean            cogl_is_offscreen                   (CoglHandle handle);

Determines whether the given CoglHandle references an offscreen buffer object.

+

+

@@ -160,8 +175,8 @@ - @@ -170,12 +185,14 @@

cogl_set_framebuffer ()

-
void                cogl_set_framebuffer                (CoglHandle buffer);
+
void                cogl_set_framebuffer                (CoglHandle buffer);

This redirects all subsequent drawing to the specified framebuffer. This can either be an offscreen buffer created with cogl_offscreen_new_to_texture() or you can revert to your original onscreen window buffer.

+

+

Returns :

TRUE if the handle references an offscreen buffer, - FALSE otherwise + TRUE if the handle references an offscreen buffer, + FALSE otherwise
@@ -190,7 +207,7 @@

cogl_push_framebuffer ()

-
void                cogl_push_framebuffer               (CoglHandle buffer);
+
void                cogl_push_framebuffer               (CoglHandle buffer);

Redirects all subsequent drawing to the specified framebuffer. This can either be an offscreen buffer created with @@ -199,6 +216,8 @@

The previous framebuffer can be restored by calling cogl_pop_framebuffer()

+

+

@@ -213,17 +232,19 @@

cogl_pop_framebuffer ()

-
void                cogl_pop_framebuffer                (void);
+
void                cogl_pop_framebuffer                (void);

Restores the framebuffer that was previously at the top of the stack. All subsequent drawing will be redirected to this framebuffer.

+

+

Since 1.2


cogl_set_draw_buffer ()

-
void                cogl_set_draw_buffer                (CoglBufferTarget target,
-                                                         CoglHandle offscreen);
+
void                cogl_set_draw_buffer                (CoglBufferTarget target,
+                                                         CoglHandle offscreen);

Warning

cogl_set_draw_buffer has been deprecated since version 1.2 and should not be used in newly-written code. The target argument was redundant since we could look at @@ -234,6 +255,8 @@ can either be an offscreen buffer created with cogl_offscreen_new_to_texture() or you can revert to your original on screen window buffer.

+

+

@@ -255,29 +278,33 @@

cogl_pop_draw_buffer ()

-
void                cogl_pop_draw_buffer                (void);
+
void                cogl_pop_draw_buffer                (void);

Warning

cogl_pop_draw_buffer has been deprecated since version 1.2 and should not be used in newly-written code. The draw buffer API was replaced with a framebuffer API

Restore cogl_set_draw_buffer() state.

+

+


cogl_push_draw_buffer ()

-
void                cogl_push_draw_buffer               (void);
+
void                cogl_push_draw_buffer               (void);

Warning

cogl_push_draw_buffer has been deprecated since version 1.2 and should not be used in newly-written code. The draw buffer API was replaced with a framebuffer API

Save cogl_set_draw_buffer() state.

+

+

+ Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/cogl/html/cogl-Primitives.html +++ clutter-1.0-1.2.4/doc/reference/cogl/html/cogl-Primitives.html @@ -8,7 +8,7 @@ - + @@ -30,8 +30,8 @@
Top -  |  - Description +  |  + Description
@@ -45,88 +45,91 @@

Synopsis

-
void                cogl_rectangle                      (float x_1,
-                                                         float y_1,
-                                                         float x_2,
-                                                         float y_2);
-void                cogl_rectangles                     (const float *verts,
-                                                         unsigned int n_rects);
-void                cogl_rectangle_with_texture_coords  (float x1,
-                                                         float y1,
-                                                         float x2,
-                                                         float y2,
-                                                         float tx1,
-                                                         float ty1,
-                                                         float tx2,
-                                                         float ty2);
-void                cogl_rectangles_with_texture_coords (const float *verts,
-                                                         unsigned int n_rects);
-void                cogl_rectangle_with_multitexture_coords
-                                                        (float x1,
-                                                         float y1,
-                                                         float x2,
-                                                         float y2,
-                                                         const float *tex_coords,
-                                                         int tex_coords_len);
-void                cogl_polygon                        (const CoglTextureVertex *vertices,
-                                                         unsigned int n_vertices,
-                                                         gboolean use_color);
+
+void                cogl_rectangle                      (float x_1,
+                                                         float y_1,
+                                                         float x_2,
+                                                         float y_2);
+void                cogl_rectangles                     (const float *verts,
+                                                         unsigned int n_rects);
+void                cogl_rectangle_with_texture_coords  (float x1,
+                                                         float y1,
+                                                         float x2,
+                                                         float y2,
+                                                         float tx1,
+                                                         float ty1,
+                                                         float tx2,
+                                                         float ty2);
+void                cogl_rectangles_with_texture_coords (const float *verts,
+                                                         unsigned int n_rects);
+void                cogl_rectangle_with_multitexture_coords
+                                                        (float x1,
+                                                         float y1,
+                                                         float x2,
+                                                         float y2,
+                                                         const float *tex_coords,
+                                                         int tex_coords_len);
+void                cogl_polygon                        (const CoglTextureVertex *vertices,
+                                                         unsigned int n_vertices,
+                                                         gboolean use_color);
 
-void                cogl_path_new                       (void);
-void                cogl_path_move_to                   (float x,
-                                                         float y);
-void                cogl_path_close                     (void);
-void                cogl_path_line_to                   (float x,
-                                                         float y);
-void                cogl_path_curve_to                  (float x_1,
-                                                         float y_1,
-                                                         float x_2,
-                                                         float y_2,
-                                                         float x_3,
-                                                         float y_3);
-void                cogl_path_arc                       (float center_x,
-                                                         float center_y,
-                                                         float radius_x,
-                                                         float radius_y,
-                                                         float angle_1,
-                                                         float angle_2);
-void                cogl_path_rel_move_to               (float x,
-                                                         float y);
-void                cogl_path_rel_line_to               (float x,
-                                                         float y);
-void                cogl_path_rel_curve_to              (float x_1,
-                                                         float y_1,
-                                                         float x_2,
-                                                         float y_2,
-                                                         float x_3,
-                                                         float y_3);
-void                cogl_path_line                      (float x_1,
-                                                         float y_1,
-                                                         float x_2,
-                                                         float y_2);
-void                cogl_path_polyline                  (float *coords,
-                                                         int num_points);
-void                cogl_path_polygon                   (float *coords,
-                                                         int num_points);
-void                cogl_path_rectangle                 (float x_1,
-                                                         float y_1,
-                                                         float x_2,
-                                                         float y_2);
-void                cogl_path_round_rectangle           (float x_1,
-                                                         float y_1,
-                                                         float x_2,
-                                                         float y_2,
-                                                         float radius,
-                                                         float arc_step);
-void                cogl_path_ellipse                   (float center_x,
-                                                         float center_y,
-                                                         float radius_x,
-                                                         float radius_y);
+void                cogl_path_new                       (void);
+void                cogl_path_move_to                   (float x,
+                                                         float y);
+void                cogl_path_close                     (void);
+void                cogl_path_line_to                   (float x,
+                                                         float y);
+void                cogl_path_curve_to                  (float x_1,
+                                                         float y_1,
+                                                         float x_2,
+                                                         float y_2,
+                                                         float x_3,
+                                                         float y_3);
+void                cogl_path_arc                       (float center_x,
+                                                         float center_y,
+                                                         float radius_x,
+                                                         float radius_y,
+                                                         float angle_1,
+                                                         float angle_2);
+void                cogl_path_rel_move_to               (float x,
+                                                         float y);
+void                cogl_path_rel_line_to               (float x,
+                                                         float y);
+void                cogl_path_rel_curve_to              (float x_1,
+                                                         float y_1,
+                                                         float x_2,
+                                                         float y_2,
+                                                         float x_3,
+                                                         float y_3);
+void                cogl_path_line                      (float x_1,
+                                                         float y_1,
+                                                         float x_2,
+                                                         float y_2);
+void                cogl_path_polyline                  (float *coords,
+                                                         int num_points);
+void                cogl_path_polygon                   (float *coords,
+                                                         int num_points);
+void                cogl_path_rectangle                 (float x_1,
+                                                         float y_1,
+                                                         float x_2,
+                                                         float y_2);
+void                cogl_path_round_rectangle           (float x_1,
+                                                         float y_1,
+                                                         float x_2,
+                                                         float y_2,
+                                                         float radius,
+                                                         float arc_step);
+void                cogl_path_ellipse                   (float center_x,
+                                                         float center_y,
+                                                         float radius_x,
+                                                         float radius_y);
 
-void                cogl_path_fill                      (void);
-void                cogl_path_fill_preserve             (void);
-void                cogl_path_stroke                    (void);
-void                cogl_path_stroke_preserve           (void);
+void                cogl_path_fill                      (void);
+void                cogl_path_fill_preserve             (void);
+void                cogl_path_stroke                    (void);
+void                cogl_path_stroke_preserve           (void);
 
@@ -135,17 +138,21 @@ The primitives API provides utilities for drawing some common 3D shapes in a more convenient way than the CoglVertexBuffer API provides.

+

+

Details

cogl_rectangle ()

-
void                cogl_rectangle                      (float x_1,
-                                                         float y_1,
-                                                         float x_2,
-                                                         float y_2);
+
void                cogl_rectangle                      (float x_1,
+                                                         float y_1,
+                                                         float x_2,
+                                                         float y_2);

Fills a rectangle at the given coordinates with the current source material

+

+

@@ -175,8 +182,8 @@

cogl_rectangles ()

-
void                cogl_rectangles                     (const float *verts,
-                                                         unsigned int n_rects);
+
void                cogl_rectangles                     (const float *verts,
+                                                         unsigned int n_rects);

Draws a series of rectangles in the same way that cogl_rectangle() does. In some situations it can give a @@ -188,12 +195,14 @@ n_rects * 4 elements. Each group of 4 values corresponds to the parameters x1, y1, x2, and y2, and have the same meaning as in cogl_rectangle().

+

+

- + @@ -207,18 +216,20 @@

cogl_rectangle_with_texture_coords ()

-
void                cogl_rectangle_with_texture_coords  (float x1,
-                                                         float y1,
-                                                         float x2,
-                                                         float y2,
-                                                         float tx1,
-                                                         float ty1,
-                                                         float tx2,
-                                                         float ty2);
+
void                cogl_rectangle_with_texture_coords  (float x1,
+                                                         float y1,
+                                                         float x2,
+                                                         float y2,
+                                                         float tx1,
+                                                         float ty1,
+                                                         float tx2,
+                                                         float ty2);

Draw a rectangle using the current material and supply texture coordinates to be used for the first texture layer of the material. To draw the entire texture pass in tx1=0.0 ty1=0.0 tx2=1.0 ty2=1.0.

+

+

verts :

an array of vertices. in. array. transfer none. an array of vertices. in. array. transfer none.

n_rects :

@@ -269,8 +280,8 @@

cogl_rectangles_with_texture_coords ()

-
void                cogl_rectangles_with_texture_coords (const float *verts,
-                                                         unsigned int n_rects);
+
void                cogl_rectangles_with_texture_coords (const float *verts,
+                                                         unsigned int n_rects);

Draws a series of rectangles in the same way that cogl_rectangle_with_texture_coords() does. In some situations it can give a @@ -282,12 +293,14 @@ n_rects * 8 elements. Each group of 8 values corresponds to the parameters x1, y1, x2, y2, tx1, ty1, tx2 and ty2 and have the same meaning as in cogl_rectangle_with_texture_coords().

+

+

- + @@ -301,13 +314,13 @@

cogl_rectangle_with_multitexture_coords ()

-
void                cogl_rectangle_with_multitexture_coords
-                                                        (float x1,
-                                                         float y1,
-                                                         float x2,
-                                                         float y2,
-                                                         const float *tex_coords,
-                                                         int tex_coords_len);
+
void                cogl_rectangle_with_multitexture_coords
+                                                        (float x1,
+                                                         float y1,
+                                                         float x2,
+                                                         float y2,
+                                                         const float *tex_coords,
+                                                         int tex_coords_len);

This function draws a rectangle using the current source material to texture or fill with. As a material may contain multiple texture layers @@ -319,6 +332,8 @@ layer index) and if you supply less texture coordinates than there are layers in the current source material then default texture coordinates (0.0, 0.0, 1.0, 1.0) are generated.

+

+

verts :

an array of vertices. in. array. transfer none. an array of vertices. in. array. transfer none.

n_rects :

@@ -344,7 +359,7 @@ - + @@ -359,15 +374,17 @@

cogl_polygon ()

-
void                cogl_polygon                        (const CoglTextureVertex *vertices,
-                                                         unsigned int n_vertices,
-                                                         gboolean use_color);
+
void                cogl_polygon                        (const CoglTextureVertex *vertices,
+                                                         unsigned int n_vertices,
+                                                         gboolean use_color);

Draws a convex polygon using the current source material to fill / texture with according to the texture coordinates passed.

-If use_color is TRUE then the color will be changed for each vertex using +If use_color is TRUE then the color will be changed for each vertex using the value specified in the color member of CoglTextureVertex. This can be used for example to make the texture fade out by setting the alpha value of the color. @@ -381,6 +398,8 @@ only work if either the texture is not sliced or the backend is not OpenGL ES and the minifying and magnifying functions are both set to COGL_MATERIAL_FILTER_NEAREST.

+

+

tex_coords :

in) (array) (transfer none. in. array. transfer none. in) (array) (transfer none. in. array. transfer none.

tex_coords_len :

@@ -396,7 +415,7 @@ - @@ -406,19 +425,23 @@

cogl_path_new ()

-
void                cogl_path_new                       (void);
+
void                cogl_path_new                       (void);

Clears the current path and starts a new one.

+

+

Since 1.0


cogl_path_move_to ()

-
void                cogl_path_move_to                   (float x,
-                                                         float y);
+
void                cogl_path_move_to                   (float x,
+                                                         float y);

Moves the pen to the given location. If there is an existing path this will start a new disjoint subpath.

+

+

use_color :

TRUE if the color member of CoglTextureVertex should be used + TRUE if the color member of CoglTextureVertex should be used
@@ -438,19 +461,23 @@

cogl_path_close ()

-
void                cogl_path_close                     (void);
+
void                cogl_path_close                     (void);

Closes the path being constructed by adding a straight line segment to it that ends at the first vertex of the path.

+

+


cogl_path_line_to ()

-
void                cogl_path_line_to                   (float x,
-                                                         float y);
+
void                cogl_path_line_to                   (float x,
+                                                         float y);

Adds a straight line segment to the current path that ends at the given coordinates.

+

+

@@ -470,16 +497,18 @@

cogl_path_curve_to ()

-
void                cogl_path_curve_to                  (float x_1,
-                                                         float y_1,
-                                                         float x_2,
-                                                         float y_2,
-                                                         float x_3,
-                                                         float y_3);
+
void                cogl_path_curve_to                  (float x_1,
+                                                         float y_1,
+                                                         float x_2,
+                                                         float y_2,
+                                                         float x_3,
+                                                         float y_3);

Adds a cubic bezier curve segment to the current path with the given second, third and fourth control points and using current pen location as the first control point.

+

+

@@ -519,17 +548,19 @@

cogl_path_arc ()

-
void                cogl_path_arc                       (float center_x,
-                                                         float center_y,
-                                                         float radius_x,
-                                                         float radius_y,
-                                                         float angle_1,
-                                                         float angle_2);
+
void                cogl_path_arc                       (float center_x,
+                                                         float center_y,
+                                                         float radius_x,
+                                                         float radius_y,
+                                                         float angle_1,
+                                                         float angle_2);

Adds an elliptical arc segment to the current path. A straight line segment will link the current pen location with the first vertex of the arc. If you perform a move_to to the arcs start just before drawing it you create a free standing arc.

+

+

@@ -569,12 +600,14 @@

cogl_path_rel_move_to ()

-
void                cogl_path_rel_move_to               (float x,
-                                                         float y);
+
void                cogl_path_rel_move_to               (float x,
+                                                         float y);

Moves the pen to the given offset relative to the current pen location. If there is an existing path this will start a new disjoint subpath.

+

+

@@ -594,11 +627,13 @@

cogl_path_rel_line_to ()

-
void                cogl_path_rel_line_to               (float x,
-                                                         float y);
+
void                cogl_path_rel_line_to               (float x,
+                                                         float y);

Adds a straight line segment to the current path that ends at the given coordinates relative to the current pen location.

+

+

@@ -618,17 +653,19 @@

cogl_path_rel_curve_to ()

-
void                cogl_path_rel_curve_to              (float x_1,
-                                                         float y_1,
-                                                         float x_2,
-                                                         float y_2,
-                                                         float x_3,
-                                                         float y_3);
+
void                cogl_path_rel_curve_to              (float x_1,
+                                                         float y_1,
+                                                         float x_2,
+                                                         float y_2,
+                                                         float x_3,
+                                                         float y_3);

Adds a cubic bezier curve segment to the current path with the given second, third and fourth control points and using current pen location as the first control point. The given coordinates are relative to the current pen location.

+

+

@@ -668,14 +705,16 @@

cogl_path_line ()

-
void                cogl_path_line                      (float x_1,
-                                                         float y_1,
-                                                         float x_2,
-                                                         float y_2);
+
void                cogl_path_line                      (float x_1,
+                                                         float y_1,
+                                                         float x_2,
+                                                         float y_2);

Constructs a straight line shape starting and ending at the given coordinates. If there is an existing path this will start a new disjoint sub-path.

+

+

@@ -705,8 +744,8 @@

cogl_path_polyline ()

-
void                cogl_path_polyline                  (float *coords,
-                                                         int num_points);
+
void                cogl_path_polyline                  (float *coords,
+                                                         int num_points);

Constructs a series of straight line segments, starting from the first given vertex coordinate. If there is an existing path this @@ -720,12 +759,14 @@ represents the Y coordinate of the first vertex, continuing in the same fashion for the rest of the vertices. (num_points - 1) segments will be constructed.

+

+

- + @@ -738,8 +779,8 @@

cogl_path_polygon ()

-
void                cogl_path_polygon                   (float *coords,
-                                                         int num_points);
+
void                cogl_path_polygon                   (float *coords,
+                                                         int num_points);

Constructs a polygonal shape of the given number of vertices. If there is an existing path this will start a new disjoint sub-path. @@ -749,12 +790,14 @@ represents the X coordinate of the first vertex, the second value represents the Y coordinate of the first vertex, continuing in the same fashion for the rest of the vertices.

+

+

coords :

in) (array) (transfer none. in. array. transfer none. in) (array) (transfer none. in. array. transfer none.

num_points :

- + @@ -767,13 +810,15 @@

cogl_path_rectangle ()

-
void                cogl_path_rectangle                 (float x_1,
-                                                         float y_1,
-                                                         float x_2,
-                                                         float y_2);
+
void                cogl_path_rectangle                 (float x_1,
+                                                         float y_1,
+                                                         float x_2,
+                                                         float y_2);

Constructs a rectangular shape at the given coordinates. If there is an existing path this will start a new disjoint sub-path.

+

+

coords :

in) (array) (transfer none. in. array. transfer none. in) (array) (transfer none. in. array. transfer none.

num_points :

@@ -803,15 +848,17 @@

cogl_path_round_rectangle ()

-
void                cogl_path_round_rectangle           (float x_1,
-                                                         float y_1,
-                                                         float x_2,
-                                                         float y_2,
-                                                         float radius,
-                                                         float arc_step);
+
void                cogl_path_round_rectangle           (float x_1,
+                                                         float y_1,
+                                                         float x_2,
+                                                         float y_2,
+                                                         float radius,
+                                                         float arc_step);

Constructs a rectangular shape with rounded corners. If there is an existing path this will start a new disjoint sub-path.

+

+

@@ -852,13 +899,15 @@

cogl_path_ellipse ()

-
void                cogl_path_ellipse                   (float center_x,
-                                                         float center_y,
-                                                         float radius_x,
-                                                         float radius_y);
+
void                cogl_path_ellipse                   (float center_x,
+                                                         float center_y,
+                                                         float radius_x,
+                                                         float radius_y);

Constructs an ellipse shape. If there is an existing path this will start a new disjoint sub-path.

+

+

@@ -888,44 +937,52 @@

cogl_path_fill ()

-
void                cogl_path_fill                      (void);
+
void                cogl_path_fill                      (void);

Fills the constructed shape using the current drawing color. The current path is then cleared. To use the path again, call cogl_path_fill_preserve() instead.

+

+


cogl_path_fill_preserve ()

-
void                cogl_path_fill_preserve             (void);
+
void                cogl_path_fill_preserve             (void);

Fills the constructed shape using the current drawing color and preserves the path to be used again.

+

+

Since 1.0


cogl_path_stroke ()

-
void                cogl_path_stroke                    (void);
+
void                cogl_path_stroke                    (void);

Strokes the constructed shape using the current drawing color and a width of 1 pixel (regardless of the current transformation matrix). To current path is then cleared. To use the path again, call cogl_path_stroke_preserve() instead.

+

+


cogl_path_stroke_preserve ()

-
void                cogl_path_stroke_preserve           (void);
+
void                cogl_path_stroke_preserve           (void);

Strokes the constructed shape using the current drawing color and preserves the path to be used again.

+

+

Since 1.0

+ Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/cogl/html/cogl-Blend-Strings.html +++ clutter-1.0-1.2.4/doc/reference/cogl/html/cogl-Blend-Strings.html @@ -8,7 +8,7 @@ - + @@ -29,8 +29,8 @@
Next
-  |  - Cogl Blend Strings +  |  + Cogl Blend Strings
@@ -52,7 +52,7 @@

-Some examples

+Some examples

Here is an example used for blending:

 "RGBA = ADD (SRC_COLOR * (SRC_COLOR[A]), DST_COLOR * (1-SRC_COLOR[A]))"
@@ -146,6 +146,6 @@
 
+ Generated by GTK-Doc V1.11
- \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/cogl/html/cogl-Textures.html +++ clutter-1.0-1.2.4/doc/reference/cogl/html/cogl-Textures.html @@ -8,7 +8,7 @@ - + @@ -30,8 +30,8 @@ Top -  |  - Description +  |  + Description
@@ -45,67 +45,84 @@

Synopsis

-
                    CoglTextureVertex;
+
+                    CoglTextureVertex;
 enum                CoglTextureFlags;
-CoglHandle          cogl_texture_new_with_size          (unsigned int width,
-                                                         unsigned int height,
-                                                         CoglTextureFlags flags,
-                                                         CoglPixelFormat internal_format);
-CoglHandle          cogl_texture_new_from_file          (const char *filename,
-                                                         CoglTextureFlags flags,
-                                                         CoglPixelFormat internal_format,
-                                                         GError **error);
-CoglHandle          cogl_texture_new_from_data          (unsigned int width,
-                                                         unsigned int height,
-                                                         CoglTextureFlags flags,
-                                                         CoglPixelFormat format,
-                                                         CoglPixelFormat internal_format,
-                                                         unsigned int rowstride,
-                                                         const guint8 *data);
-CoglHandle          cogl_texture_new_from_foreign       (GLuint gl_handle,
-                                                         GLenum gl_target,
-                                                         GLuint width,
-                                                         GLuint height,
-                                                         GLuint x_pot_waste,
-                                                         GLuint y_pot_waste,
-                                                         CoglPixelFormat format);
-CoglHandle          cogl_texture_new_from_bitmap        (CoglHandle bmp_handle,
-                                                         CoglTextureFlags flags,
-                                                         CoglPixelFormat internal_format);
-CoglHandle          cogl_texture_new_from_sub_texture   (CoglHandle full_texture,
-                                                         int sub_x,
-                                                         int sub_y,
-                                                         int sub_width,
-                                                         int sub_height);
-gboolean            cogl_is_texture                     (CoglHandle handle);
-CoglHandle          cogl_texture_ref                    (CoglHandle handle);
-void                cogl_texture_unref                  (CoglHandle handle);
+CoglHandle          cogl_texture_new_with_size          (unsigned int width,
+                                                         unsigned int height,
+                                                         CoglTextureFlags flags,
+                                                         CoglPixelFormat internal_format);
+CoglHandle          cogl_texture_new_from_file          (const char *filename,
+                                                         CoglTextureFlags flags,
+                                                         CoglPixelFormat internal_format,
+                                                         GError **error);
+CoglHandle          cogl_texture_new_from_data          (unsigned int width,
+                                                         unsigned int height,
+                                                         CoglTextureFlags flags,
+                                                         CoglPixelFormat format,
+                                                         CoglPixelFormat internal_format,
+                                                         unsigned int rowstride,
+                                                         const guint8 *data);
+CoglHandle          cogl_texture_new_from_foreign       (GLuint gl_handle,
+                                                         GLenum gl_target,
+                                                         GLuint width,
+                                                         GLuint height,
+                                                         GLuint x_pot_waste,
+                                                         GLuint y_pot_waste,
+                                                         CoglPixelFormat format);
+CoglHandle          cogl_texture_new_from_bitmap        (CoglHandle bmp_handle,
+                                                         CoglTextureFlags flags,
+                                                         CoglPixelFormat internal_format);
+CoglHandle          cogl_texture_new_from_sub_texture   (CoglHandle full_texture,
+                                                         int sub_x,
+                                                         int sub_y,
+                                                         int sub_width,
+                                                         int sub_height);
+gboolean            cogl_is_texture                     (CoglHandle handle);
+CoglHandle          cogl_texture_ref                    (CoglHandle handle);
+void                cogl_texture_unref                  (CoglHandle handle);
 
-unsigned int        cogl_texture_get_width              (CoglHandle handle);
-unsigned int        cogl_texture_get_height             (CoglHandle handle);
-CoglPixelFormat     cogl_texture_get_format             (CoglHandle handle);
-unsigned int        cogl_texture_get_rowstride          (CoglHandle handle);
-int                 cogl_texture_get_max_waste          (CoglHandle handle);
-gboolean            cogl_texture_is_sliced              (CoglHandle handle);
-gboolean            cogl_texture_get_gl_texture         (CoglHandle handle,
-                                                         GLuint *out_gl_handle,
-                                                         GLenum *out_gl_target);
-int                 cogl_texture_get_data               (CoglHandle handle,
-                                                         CoglPixelFormat format,
-                                                         unsigned int rowstride,
-                                                         guint8 *data);
-gboolean            cogl_texture_set_region             (CoglHandle handle,
-                                                         int src_x,
-                                                         int src_y,
-                                                         int dst_x,
-                                                         int dst_y,
-                                                         unsigned int dst_width,
-                                                         unsigned int dst_height,
-                                                         int width,
-                                                         int height,
-                                                         CoglPixelFormat format,
-                                                         unsigned int rowstride,
-                                                         const guint8 *data);
+unsigned int        cogl_texture_get_width              (CoglHandle handle);
+unsigned int        cogl_texture_get_height             (CoglHandle handle);
+CoglPixelFormat     cogl_texture_get_format             (CoglHandle handle);
+unsigned int        cogl_texture_get_rowstride          (CoglHandle handle);
+int                 cogl_texture_get_max_waste          (CoglHandle handle);
+gboolean            cogl_texture_is_sliced              (CoglHandle handle);
+gboolean            cogl_texture_get_gl_texture         (CoglHandle handle,
+                                                         GLuint *out_gl_handle,
+                                                         GLenum *out_gl_target);
+int                 cogl_texture_get_data               (CoglHandle handle,
+                                                         CoglPixelFormat format,
+                                                         unsigned int rowstride,
+                                                         guint8 *data);
+gboolean            cogl_texture_set_region             (CoglHandle handle,
+                                                         int src_x,
+                                                         int src_y,
+                                                         int dst_x,
+                                                         int dst_y,
+                                                         unsigned int dst_width,
+                                                         unsigned int dst_height,
+                                                         int width,
+                                                         int height,
+                                                         CoglPixelFormat format,
+                                                         unsigned int rowstride,
+                                                         const guint8 *data);
 
@@ -114,6 +131,8 @@ COGL allows creating and manipulating GL textures using a uniform API that tries to hide all the various complexities of creating, loading and manipulating textures.

+

+

Details

@@ -128,38 +147,40 @@

Used to specify vertex information when calling cogl_polygon()

+

+

- + - + - + - + - + - + @@ -177,16 +198,18 @@

Flags to pass to the cogl_texture_new_* family of functions.

+

+

float x;

float x;

Model x-coordinate

float y;

float y;

Model y-coordinate

float z;

float z;

Model z-coordinate

float tx;

float tx;

Texture x-coordinate

float ty;

float ty;

Texture y-coordinate

CoglColor color;

CoglColor color;

The color to use at this vertex. This is ignored if - use_color is FALSE when calling cogl_polygon() + use_color is FALSE when calling cogl_polygon()
- + - + - + - + @@ -212,12 +235,14 @@

cogl_texture_new_with_size ()

-
CoglHandle          cogl_texture_new_with_size          (unsigned int width,
-                                                         unsigned int height,
-                                                         CoglTextureFlags flags,
-                                                         CoglPixelFormat internal_format);
+
CoglHandle          cogl_texture_new_with_size          (unsigned int width,
+                                                         unsigned int height,
+                                                         CoglTextureFlags flags,
+                                                         CoglPixelFormat internal_format);

Creates a new COGL texture with the specified dimensions and pixel format.

+

+

COGL_TEXTURE_NONE

COGL_TEXTURE_NONE

No flags specified

COGL_TEXTURE_NO_AUTO_MIPMAP

COGL_TEXTURE_NO_AUTO_MIPMAP

Disables the automatic generation of the mipmap pyramid from the base level image whenever it is updated. The mipmaps are only generated when the texture is @@ -195,12 +218,12 @@

COGL_TEXTURE_NO_SLICING

COGL_TEXTURE_NO_SLICING

Disables the slicing of the texture

COGL_TEXTURE_NO_ATLAS

COGL_TEXTURE_NO_ATLAS

Disables the insertion of the texture inside the texture atlas used by Cogl
@@ -233,7 +258,7 @@ - @@ -245,7 +270,7 @@ @@ -256,12 +281,16 @@

cogl_texture_new_from_file ()

-
CoglHandle          cogl_texture_new_from_file          (const char *filename,
-                                                         CoglTextureFlags flags,
-                                                         CoglPixelFormat internal_format,
-                                                         GError **error);
+
CoglHandle          cogl_texture_new_from_file          (const char *filename,
+                                                         CoglTextureFlags flags,
+                                                         CoglPixelFormat internal_format,
+                                                         GError **error);

Creates a COGL texture from an image file.

+

+

flags :

Optional flags for the texture, or COGL_TEXTURE_NONE + Optional flags for the texture, or COGL_TEXTURE_NONE

Returns :

a CoglHandle to the newly created texture or - COGL_INVALID_HANDLE on failure + COGL_INVALID_HANDLE on failure
@@ -272,13 +301,13 @@ - - @@ -306,15 +337,19 @@

cogl_texture_new_from_data ()

-
CoglHandle          cogl_texture_new_from_data          (unsigned int width,
-                                                         unsigned int height,
-                                                         CoglTextureFlags flags,
-                                                         CoglPixelFormat format,
-                                                         CoglPixelFormat internal_format,
-                                                         unsigned int rowstride,
-                                                         const guint8 *data);
+
CoglHandle          cogl_texture_new_from_data          (unsigned int width,
+                                                         unsigned int height,
+                                                         CoglTextureFlags flags,
+                                                         CoglPixelFormat format,
+                                                         CoglPixelFormat internal_format,
+                                                         unsigned int rowstride,
+                                                         const guint8 *data);

Creates a new COGL texture based on data residing in memory.

+

+

flags :

Optional flags for the texture, or COGL_TEXTURE_NONE + Optional flags for the texture, or COGL_TEXTURE_NONE

internal_format :

the CoglPixelFormat to use for the GPU storage of the - texture. If COGL_PIXEL_FORMAT_ANY is given then a premultiplied + texture. If COGL_PIXEL_FORMAT_ANY is given then a premultiplied format similar to the format of the source data will be used. The default blending equations of Cogl expect premultiplied color data; the main use of passing a non-premultiplied format here is if you @@ -289,13 +318,15 @@

error :

return location for a GError or NULL + return location for a GError or NULL

Returns :

a CoglHandle to the newly created texture or - COGL_INVALID_HANDLE on failure + COGL_INVALID_HANDLE on failure
@@ -330,7 +365,7 @@ - @@ -364,7 +399,7 @@ @@ -375,13 +410,13 @@

cogl_texture_new_from_foreign ()

-
CoglHandle          cogl_texture_new_from_foreign       (GLuint gl_handle,
-                                                         GLenum gl_target,
-                                                         GLuint width,
-                                                         GLuint height,
-                                                         GLuint x_pot_waste,
-                                                         GLuint y_pot_waste,
-                                                         CoglPixelFormat format);
+
CoglHandle          cogl_texture_new_from_foreign       (GLuint gl_handle,
+                                                         GLenum gl_target,
+                                                         GLuint width,
+                                                         GLuint height,
+                                                         GLuint x_pot_waste,
+                                                         GLuint y_pot_waste,
+                                                         CoglPixelFormat format);

Creates a COGL texture based on an existing OpenGL texture; the width, height and format are passed along since it is not always @@ -394,6 +429,8 @@ non-power-of-two image into a larger power-of-two texture and use the waste arguments to tell Cogl which region should be mapped to the texture coordinate range [0:1].

+

+

flags :

Optional flags for the texture, or COGL_TEXTURE_NONE + Optional flags for the texture, or COGL_TEXTURE_NONE

Returns :

a CoglHandle to the newly created texture or - COGL_INVALID_HANDLE on failure + COGL_INVALID_HANDLE on failure
@@ -435,7 +472,7 @@ @@ -446,11 +483,13 @@

cogl_texture_new_from_bitmap ()

-
CoglHandle          cogl_texture_new_from_bitmap        (CoglHandle bmp_handle,
-                                                         CoglTextureFlags flags,
-                                                         CoglPixelFormat internal_format);
+
CoglHandle          cogl_texture_new_from_bitmap        (CoglHandle bmp_handle,
+                                                         CoglTextureFlags flags,
+                                                         CoglPixelFormat internal_format);

Creates a COGL texture from a CoglBitmap.

+

+

Returns :

a CoglHandle to the newly created texture or - COGL_INVALID_HANDLE on failure + COGL_INVALID_HANDLE on failure
@@ -461,7 +500,7 @@ - @@ -473,7 +512,7 @@ @@ -484,11 +523,11 @@

cogl_texture_new_from_sub_texture ()

-
CoglHandle          cogl_texture_new_from_sub_texture   (CoglHandle full_texture,
-                                                         int sub_x,
-                                                         int sub_y,
-                                                         int sub_width,
-                                                         int sub_height);
+
CoglHandle          cogl_texture_new_from_sub_texture   (CoglHandle full_texture,
+                                                         int sub_x,
+                                                         int sub_y,
+                                                         int sub_width,
+                                                         int sub_height);

Creates a new texture which represents a subregion of another texture. The GL resources will be shared so that no new texture @@ -503,6 +542,8 @@ The sub texture will keep a reference to the full texture so you do not need to keep one separately if you only want to use the sub texture.

+

+

flags :

Optional flags for the texture, or COGL_TEXTURE_NONE + Optional flags for the texture, or COGL_TEXTURE_NONE

Returns :

a CoglHandle to the newly created texture or - COGL_INVALID_HANDLE on failure + COGL_INVALID_HANDLE on failure
@@ -544,9 +585,13 @@

cogl_is_texture ()

-
gboolean            cogl_is_texture                     (CoglHandle handle);
+
gboolean            cogl_is_texture                     (CoglHandle handle);

Gets whether the given handle references an existing texture object.

+

+

@@ -557,8 +602,8 @@ - @@ -567,13 +612,15 @@

cogl_texture_ref ()

-
CoglHandle          cogl_texture_ref                    (CoglHandle handle);
+
CoglHandle          cogl_texture_ref                    (CoglHandle handle);

Warning

cogl_texture_ref has been deprecated since version 1.2 and should not be used in newly-written code. Use cogl_handle_ref() instead

Increment the reference count for a cogl texture.

+

+

Returns :

TRUE if the handle references a texture, and - FALSE otherwise + TRUE if the handle references a texture, and + FALSE otherwise
@@ -593,13 +640,15 @@

cogl_texture_unref ()

-
void                cogl_texture_unref                  (CoglHandle handle);
+
void                cogl_texture_unref                  (CoglHandle handle);

Warning

cogl_texture_unref has been deprecated since version 1.2 and should not be used in newly-written code. Use cogl_handle_unref() instead

Decrement the reference count for a cogl texture.

+

+

@@ -612,9 +661,11 @@

cogl_texture_get_width ()

-
unsigned int        cogl_texture_get_width              (CoglHandle handle);
+
unsigned int        cogl_texture_get_width              (CoglHandle handle);

Queries the width of a cogl texture.

+

+

@@ -634,9 +685,11 @@

cogl_texture_get_height ()

-
unsigned int        cogl_texture_get_height             (CoglHandle handle);
+
unsigned int        cogl_texture_get_height             (CoglHandle handle);

Queries the height of a cogl texture.

+

+

@@ -656,9 +709,11 @@

cogl_texture_get_format ()

-
CoglPixelFormat     cogl_texture_get_format             (CoglHandle handle);
+
CoglPixelFormat     cogl_texture_get_format             (CoglHandle handle);

Queries the CoglPixelFormat of a cogl texture.

+

+

@@ -678,9 +733,11 @@

cogl_texture_get_rowstride ()

-
unsigned int        cogl_texture_get_rowstride          (CoglHandle handle);
+
unsigned int        cogl_texture_get_rowstride          (CoglHandle handle);

Queries the rowstride of a cogl texture.

+

+

@@ -700,10 +757,12 @@

cogl_texture_get_max_waste ()

-
int                 cogl_texture_get_max_waste          (CoglHandle handle);
+
int                 cogl_texture_get_max_waste          (CoglHandle handle);

Queries the maximum wasted (unused) pixels in one dimension of a GPU side texture.

+

+

@@ -723,10 +782,14 @@

cogl_texture_is_sliced ()

-
gboolean            cogl_texture_is_sliced              (CoglHandle handle);
+
gboolean            cogl_texture_is_sliced              (CoglHandle handle);

Queries if a texture is sliced (stored as multiple GPU side tecture objects).

+

+

@@ -737,7 +800,7 @@ - @@ -747,15 +810,19 @@

cogl_texture_get_gl_texture ()

-
gboolean            cogl_texture_get_gl_texture         (CoglHandle handle,
-                                                         GLuint *out_gl_handle,
-                                                         GLenum *out_gl_target);
+
gboolean            cogl_texture_get_gl_texture         (CoglHandle handle,
+                                                         GLuint *out_gl_handle,
+                                                         GLenum *out_gl_target);

Queries the GL handles for a GPU side texture through its CoglHandle.

If the texture is spliced the data for the first sub texture will be queried.

+

+

Returns :

TRUE if the texture is sliced, FALSE if the texture + TRUE if the texture is sliced, FALSE if the texture is stored as a single GPU texture
@@ -774,7 +841,7 @@ - @@ -784,12 +851,16 @@

cogl_texture_get_data ()

-
int                 cogl_texture_get_data               (CoglHandle handle,
-                                                         CoglPixelFormat format,
-                                                         unsigned int rowstride,
-                                                         guint8 *data);
+
int                 cogl_texture_get_data               (CoglHandle handle,
+                                                         CoglPixelFormat format,
+                                                         unsigned int rowstride,
+                                                         guint8 *data);

Copies the pixel data from a cogl texture to system memory.

+

+

Returns :

TRUE if the handle was successfully retrieved, FALSE + TRUE if the handle was successfully retrieved, FALSE if the handle was invalid
@@ -811,7 +882,7 @@ - @@ -827,21 +898,27 @@

cogl_texture_set_region ()

-
gboolean            cogl_texture_set_region             (CoglHandle handle,
-                                                         int src_x,
-                                                         int src_y,
-                                                         int dst_x,
-                                                         int dst_y,
-                                                         unsigned int dst_width,
-                                                         unsigned int dst_height,
-                                                         int width,
-                                                         int height,
-                                                         CoglPixelFormat format,
-                                                         unsigned int rowstride,
-                                                         const guint8 *data);
+
gboolean            cogl_texture_set_region             (CoglHandle handle,
+                                                         int src_x,
+                                                         int src_y,
+                                                         int dst_x,
+                                                         int dst_y,
+                                                         unsigned int dst_width,
+                                                         unsigned int dst_height,
+                                                         int width,
+                                                         int height,
+                                                         CoglPixelFormat format,
+                                                         unsigned int rowstride,
+                                                         const guint8 *data);

Sets the pixels in a rectangular subregion of handle from an in-memory buffer containing pixel data.

+

+

data :

memory location to write contents of buffer, or NULL if we're + memory location to write contents of buffer, or NULL if we're only querying the data size through the return value.
@@ -908,8 +985,8 @@ - @@ -919,6 +996,6 @@ + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/cogl/html/ch02.html +++ clutter-1.0-1.2.4/doc/reference/cogl/html/ch02.html @@ -8,7 +8,7 @@ - + @@ -29,7 +29,7 @@

Returns :

TRUE if the subregion upload was successful, and - FALSE otherwise + TRUE if the subregion upload was successful, and + FALSE otherwise

-COGL experimental API

+COGL experimental API
About the experimental API
@@ -51,6 +51,6 @@
+ Generated by GTK-Doc V1.11
- \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/cogl/html/cogl-Fixed-Point-API.html +++ clutter-1.0-1.2.4/doc/reference/cogl/html/cogl-Fixed-Point-API.html @@ -8,7 +8,7 @@ - + @@ -30,8 +30,8 @@ Top -  |  - Description +  |  + Description
@@ -45,59 +45,76 @@

Synopsis

-
typedef             CoglFixed;
-#define             COGL_FIXED_BITS
-#define             COGL_FIXED_Q
-#define             COGL_FIXED_MAX
-#define             COGL_FIXED_MIN
-
-#define             COGL_FIXED_FROM_FLOAT               (x)
-#define             COGL_FIXED_TO_FLOAT                 (x)
-#define             COGL_FIXED_FROM_INT                 (x)
-#define             COGL_FIXED_TO_INT                   (x)
-#define             COGL_FIXED_FROM_DOUBLE              (x)
-#define             COGL_FIXED_TO_DOUBLE                (x)
-#define             COGL_FLOAT_TO_INT                   (x)
-#define             COGL_FLOAT_TO_UINT                  (x)
-
-#define             COGL_FIXED_EPSILON
-#define             COGL_FIXED_1
-#define             COGL_FIXED_0_5
-#define             COGL_FIXED_30
-#define             COGL_FIXED_45
-#define             COGL_FIXED_60
-#define             COGL_FIXED_90
-#define             COGL_FIXED_120
-#define             COGL_FIXED_180
-#define             COGL_FIXED_240
-#define             COGL_FIXED_255
-#define             COGL_FIXED_270
-#define             COGL_FIXED_360
-
-#define             COGL_FIXED_MUL                      (a,b)
-#define             COGL_FIXED_DIV                      (a,b)
-#define             COGL_FIXED_MUL_DIV                  (a,b,c)
-#define             COGL_FIXED_FAST_DIV                 (a,b)
-#define             COGL_FIXED_FAST_MUL                 (a,b)
-#define             COGL_FIXED_FRACTION                 (x)
-#define             COGL_FIXED_FLOOR                    (x)
-#define             COGL_FIXED_CEIL                     (x)
-
-#define             COGL_FIXED_2_PI
-#define             COGL_FIXED_PI
-#define             COGL_FIXED_PI_2
-#define             COGL_FIXED_PI_4
-#define             COGL_RADIANS_TO_DEGREES
-
-
-CoglFixed           cogl_fixed_atan2                    (CoglFixed a,
-                                                         CoglFixed b);
-CoglFixed           cogl_fixed_atani                    (CoglFixed a);
-CoglFixed           cogl_fixed_cos                      (CoglFixed angle);
-CoglFixed           cogl_fixed_sin                      (CoglFixed angle);
-CoglFixed           cogl_fixed_tan                      (CoglFixed angle);
+
+typedef             CoglFixed;
+#define             COGL_FIXED_BITS
+#define             COGL_FIXED_Q
+#define             COGL_FIXED_MAX
+#define             COGL_FIXED_MIN
+
+#define             COGL_FIXED_FROM_FLOAT               (x)
+#define             COGL_FIXED_TO_FLOAT                 (x)
+#define             COGL_FIXED_FROM_INT                 (x)
+#define             COGL_FIXED_TO_INT                   (x)
+#define             COGL_FIXED_FROM_DOUBLE              (x)
+#define             COGL_FIXED_TO_DOUBLE                (x)
+#define             COGL_FLOAT_TO_INT                   (x)
+#define             COGL_FLOAT_TO_UINT                  (x)
+
+#define             COGL_FIXED_EPSILON
+#define             COGL_FIXED_1
+#define             COGL_FIXED_0_5
+#define             COGL_FIXED_30
+#define             COGL_FIXED_45
+#define             COGL_FIXED_60
+#define             COGL_FIXED_90
+#define             COGL_FIXED_120
+#define             COGL_FIXED_180
+#define             COGL_FIXED_240
+#define             COGL_FIXED_255
+#define             COGL_FIXED_270
+#define             COGL_FIXED_360
+
+#define             COGL_FIXED_MUL                      (a,b)
+#define             COGL_FIXED_DIV                      (a,b)
+#define             COGL_FIXED_MUL_DIV                  (a,b,c)
+#define             COGL_FIXED_FAST_DIV                 (a,b)
+#define             COGL_FIXED_FAST_MUL                 (a,b)
+#define             COGL_FIXED_FRACTION                 (x)
+#define             COGL_FIXED_FLOOR                    (x)
+#define             COGL_FIXED_CEIL                     (x)
+
+#define             COGL_FIXED_2_PI
+#define             COGL_FIXED_PI
+#define             COGL_FIXED_PI_2
+#define             COGL_FIXED_PI_4
+#define             COGL_RADIANS_TO_DEGREES
+
+#define             COGL_SQRTI_ARG_10_PERCENT
+#define             COGL_SQRTI_ARG_5_PERCENT
+#define             COGL_SQRTI_ARG_MAX
+int                 cogl_sqrti                          (int x);
+
+CoglFixed           cogl_fixed_atan2                    (CoglFixed a,
+                                                         CoglFixed b);
+CoglFixed           cogl_fixed_atani                    (CoglFixed a);
+CoglFixed           cogl_fixed_cos                      (CoglFixed angle);
+CoglFixed           cogl_fixed_log2                     (unsigned int x);
+unsigned int        cogl_fixed_pow                      (unsigned int x,
+                                                         CoglFixed y);
+unsigned int        cogl_fixed_pow2                     (CoglFixed x);
+CoglFixed           cogl_fixed_sin                      (CoglFixed angle);
+CoglFixed           cogl_fixed_sqrt                     (CoglFixed x);
+CoglFixed           cogl_fixed_tan                      (CoglFixed angle);
 
 typedef             CoglAngle;
+#define             COGL_ANGLE_FROM_DEG                 (x)
+#define             COGL_ANGLE_FROM_DEGX                (x)
+#define             COGL_ANGLE_TO_DEG                   (x)
+#define             COGL_ANGLE_TO_DEGX                  (x)
+CoglFixed           cogl_angle_cos                      (CoglAngle angle);
+CoglFixed           cogl_angle_sin                      (CoglAngle angle);
+CoglFixed           cogl_angle_tan                      (CoglAngle angle);
 
@@ -124,12 +141,14 @@
  • A fixed point number can be directly multiplied or divided by an integer.

  • Two fixed point numbers can only be multiplied and divided by - the provided COGL_FIXED_MUL and COGL_FIXED_DIV macros.

  • + the provided COGL_FIXED_MUL and COGL_FIXED_DIV macros.

    The fixed point API is available since COGL 1.0.

    +

    +

    Details

    @@ -139,51 +158,63 @@

    Fixed point number using a (16.16) notation.

    +

    +


    -

    COGL_FIXED_BITS

    +

    COGL_FIXED_BITS

    #define COGL_FIXED_BITS         (32)
     

    Evaluates to the number of bits used by the CoglFixed type.

    +

    +

    Since 1.0


    -

    COGL_FIXED_Q

    +

    COGL_FIXED_Q

    #define COGL_FIXED_Q            (COGL_FIXED_BITS - 16)
     

    Evaluates to the number of bits used for the non-integer part of the CoglFixed type.

    +

    +

    Since 1.0


    -

    COGL_FIXED_MAX

    +

    COGL_FIXED_MAX

    #define COGL_FIXED_MAX          (0x7fffffff)
     

    The biggest number representable using CoglFixed

    +

    +

    Since 1.0


    -

    COGL_FIXED_MIN

    +

    COGL_FIXED_MIN

    #define COGL_FIXED_MIN          (0x80000000)
     

    The smallest number representable using CoglFixed

    +

    +

    Since 1.0


    -

    COGL_FIXED_FROM_FLOAT()

    +

    COGL_FIXED_FROM_FLOAT()

    #define COGL_FIXED_FROM_FLOAT(x)        ((float) cogl_double_to_fixed (x))
     

    Converts x from a floating point to a fixed point notation.

    +

    +

    @@ -196,12 +227,14 @@
    -

    COGL_FIXED_TO_FLOAT()

    +

    COGL_FIXED_TO_FLOAT()

    #define COGL_FIXED_TO_FLOAT(x)          ((float) ((int)(x) / 65536.0))
     

    Converts x from a fixed point to a floating point notation, in single precision.

    +

    +

    @@ -214,11 +247,13 @@
    -

    COGL_FIXED_FROM_INT()

    +

    COGL_FIXED_FROM_INT()

    #define COGL_FIXED_FROM_INT(x)          ((x) << COGL_FIXED_Q)
     

    Converts x from an integer to a fixed point notation.

    +

    +

    @@ -231,12 +266,14 @@
    -

    COGL_FIXED_TO_INT()

    +

    COGL_FIXED_TO_INT()

    #define COGL_FIXED_TO_INT(x)            ((x) >> COGL_FIXED_Q)
     

    Converts x from a fixed point notation to an integer, dropping the fractional part without rounding.

    +

    +

    @@ -249,12 +286,14 @@
    -

    COGL_FIXED_FROM_DOUBLE()

    +

    COGL_FIXED_FROM_DOUBLE()

    #define COGL_FIXED_FROM_DOUBLE(x)       (cogl_double_to_fixed (x))
     

    Converts x from a double precision, floating point to a fixed point notation.

    +

    +

    @@ -267,12 +306,14 @@
    -

    COGL_FIXED_TO_DOUBLE()

    +

    COGL_FIXED_TO_DOUBLE()

    #define COGL_FIXED_TO_DOUBLE(x)         ((double) ((int)(x) / 65536.0))
     

    Converts x from a fixed point to a floating point notation, in double precision.

    +

    +

    @@ -285,11 +326,13 @@
    -

    COGL_FLOAT_TO_INT()

    +

    COGL_FLOAT_TO_INT()

    #define COGL_FLOAT_TO_INT(x)            (cogl_double_to_int ((x)))
     

    Converts x from a floating point notation to a signed integer.

    +

    +

    @@ -302,11 +345,13 @@
    -

    COGL_FLOAT_TO_UINT()

    +

    COGL_FLOAT_TO_UINT()

    #define COGL_FLOAT_TO_UINT(x)           (cogl_double_to_uint ((x)))
     

    Converts x from a floating point notation to an unsigned integer.

    +

    +

    @@ -319,128 +364,156 @@
    -

    COGL_FIXED_EPSILON

    +

    COGL_FIXED_EPSILON

    #define COGL_FIXED_EPSILON      (1)
     

    A very small number expressed as a CoglFixed number.

    +

    +

    Since 1.0


    -

    COGL_FIXED_1

    +

    COGL_FIXED_1

    #define COGL_FIXED_1            (1 << COGL_FIXED_Q)
     

    The number 1 expressed as a CoglFixed number.

    +

    +

    Since 1.0


    -

    COGL_FIXED_0_5

    +

    COGL_FIXED_0_5

    #define COGL_FIXED_0_5          (32768)
     

    The number 0.5 expressed as a CoglFixed number.

    +

    +

    Since 1.0


    -

    COGL_FIXED_30

    +

    COGL_FIXED_30

    #define COGL_FIXED_30           (COGL_FIXED_FROM_INT (30))
     

    Evaluates to the number 30 in fixed point notation.

    +

    +

    Since 1.0


    -

    COGL_FIXED_45

    +

    COGL_FIXED_45

    #define COGL_FIXED_45           (COGL_FIXED_FROM_INT (45))
     

    Evaluates to the number 45 in fixed point notation.

    +

    +

    Since 1.0


    -

    COGL_FIXED_60

    +

    COGL_FIXED_60

    #define COGL_FIXED_60           (COGL_FIXED_FROM_INT (60))
     

    Evaluates to the number 60 in fixed point notation.

    +

    +

    Since 1.0


    -

    COGL_FIXED_90

    +

    COGL_FIXED_90

    #define COGL_FIXED_90           (COGL_FIXED_FROM_INT (90))
     

    Evaluates to the number 90 in fixed point notation.

    +

    +

    Since 1.0


    -

    COGL_FIXED_120

    +

    COGL_FIXED_120

    #define COGL_FIXED_120          (COGL_FIXED_FROM_INT (120))
     

    Evaluates to the number 120 in fixed point notation.

    +

    +

    Since 1.0


    -

    COGL_FIXED_180

    +

    COGL_FIXED_180

    #define COGL_FIXED_180          (COGL_FIXED_FROM_INT (180))
     

    Evaluates to the number 180 in fixed point notation.

    +

    +

    Since 1.0


    -

    COGL_FIXED_240

    +

    COGL_FIXED_240

    #define COGL_FIXED_240          (COGL_FIXED_FROM_INT (240))
     

    Evaluates to the number 240 in fixed point notation.

    +

    +

    Since 1.0


    -

    COGL_FIXED_255

    +

    COGL_FIXED_255

    #define COGL_FIXED_255          (COGL_FIXED_FROM_INT (255))
     

    Evaluates to the number 255 in fixed point notation.

    +

    +

    Since 1.0


    -

    COGL_FIXED_270

    +

    COGL_FIXED_270

    #define COGL_FIXED_270          (COGL_FIXED_FROM_INT (270))
     

    Evaluates to the number 270 in fixed point notation.

    +

    +

    Since 1.0


    -

    COGL_FIXED_360

    +

    COGL_FIXED_360

    #define COGL_FIXED_360          (COGL_FIXED_FROM_INT (360))
     

    Evaluates to the number 360 in fixed point notation.

    +

    +

    Since 1.0


    -

    COGL_FIXED_MUL()

    +

    COGL_FIXED_MUL()

    #define COGL_FIXED_MUL(a,b)             (cogl_fixed_mul ((a), (b)))
     

    Computes (a * b).

    +

    +

    @@ -460,11 +533,13 @@
    -

    COGL_FIXED_DIV()

    +

    COGL_FIXED_DIV()

    #define COGL_FIXED_DIV(a,b)             (cogl_fixed_div ((a), (b)))
     

    Computes (a / b).

    +

    +

    @@ -484,7 +559,7 @@
    -

    COGL_FIXED_MUL_DIV()

    +

    COGL_FIXED_MUL_DIV()

    #define COGL_FIXED_MUL_DIV(a,b,c)       (cogl_fixed_mul_div ((a), (b), (c)))
     

    @@ -499,6 +574,8 @@

    But it is shorter to type.

    +

    +

    @@ -523,17 +600,19 @@
    -

    COGL_FIXED_FAST_DIV()

    +

    COGL_FIXED_FAST_DIV()

    #define COGL_FIXED_FAST_DIV(a,b)        ((((a) << 8) / (b)) << 8)
     

    -Fast version of COGL_FIXED_DIV, implemented as a macro. +Fast version of COGL_FIXED_DIV, implemented as a macro.

    Note

    This macro might lose precision. If the precision of the result -is important use COGL_FIXED_DIV instead.
    +is important use COGL_FIXED_DIV instead.
    +

    +

    @@ -553,17 +632,19 @@
    -

    COGL_FIXED_FAST_MUL()

    +

    COGL_FIXED_FAST_MUL()

    #define COGL_FIXED_FAST_MUL(a,b)        ((a) >> 8) * ((b) >> 8)
     

    -Fast version of COGL_FIXED_MUL, implemented as a macro. +Fast version of COGL_FIXED_MUL, implemented as a macro.

    Note

    This macro might lose precision. If the precision of the result -is important use COGL_FIXED_MUL instead.
    +is important use COGL_FIXED_MUL instead.
    +

    +

    @@ -583,11 +664,13 @@
    -

    COGL_FIXED_FRACTION()

    +

    COGL_FIXED_FRACTION()

    #define COGL_FIXED_FRACTION(x)          ((x) & ((1 << COGL_FIXED_Q) - 1))
     

    Retrieves the fractionary part of x.

    +

    +

    @@ -600,10 +683,12 @@
    -

    COGL_FIXED_FLOOR()

    +

    COGL_FIXED_FLOOR()

    #define             COGL_FIXED_FLOOR(x)

    Rounds down a fixed point number to the previous integer.

    +

    +

    @@ -616,11 +701,13 @@
    -

    COGL_FIXED_CEIL()

    +

    COGL_FIXED_CEIL()

    #define COGL_FIXED_CEIL(x)              (COGL_FIXED_FLOOR ((x) + 0xffff))
     

    Rounds up a fixed point number to the next integer.

    +

    +

    @@ -633,57 +720,135 @@
    -

    COGL_FIXED_2_PI

    +

    COGL_FIXED_2_PI

    #define COGL_FIXED_2_PI         (0x0006487f)
     

    Two times pi, expressed as a CoglFixed number.

    +

    +

    Since 1.0


    -

    COGL_FIXED_PI

    +

    COGL_FIXED_PI

    #define COGL_FIXED_PI           (0x0003243f)
     

    The number pi, expressed as a CoglFixed number.

    +

    +

    Since 1.0


    -

    COGL_FIXED_PI_2

    +

    COGL_FIXED_PI_2

    #define COGL_FIXED_PI_2         (0x00019220)
     

    Half pi, expressed as a CoglFixed number.

    +

    +

    Since 1.0


    -

    COGL_FIXED_PI_4

    +

    COGL_FIXED_PI_4

    #define COGL_FIXED_PI_4         (0x0000c910)
     

    pi / 4, expressed as CoglFixed number.

    +

    +

    Since 1.0


    -

    COGL_RADIANS_TO_DEGREES

    +

    COGL_RADIANS_TO_DEGREES

    #define COGL_RADIANS_TO_DEGREES (0x394bb8)
     

    Evaluates to 180 / pi in fixed point notation.

    +

    +

    Since 1.0


    +
    +

    COGL_SQRTI_ARG_10_PERCENT

    +
    #define             COGL_SQRTI_ARG_10_PERCENT
    +

    +Maximum argument that can be passed to cogl_sqrti() for which the +resulting error is < 10%

    +

    +

    +

    Since 1.0

    +
    +
    +
    +

    COGL_SQRTI_ARG_5_PERCENT

    +
    #define             COGL_SQRTI_ARG_5_PERCENT
    +

    +Maximum argument that can be passed to cogl_sqrti() for which the +resulting error is < 5%

    +

    +

    +

    Since 1.0

    +
    +
    +
    +

    COGL_SQRTI_ARG_MAX

    +
    #define             COGL_SQRTI_ARG_MAX
    +

    +Maximum argument that can be passed to cogl_sqrti() function.

    +

    +

    +

    Since 1.0

    +
    +
    +
    +

    cogl_sqrti ()

    +
    int                 cogl_sqrti                          (int x);
    +

    +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 +this function is COGL_SQRTI_ARG_MAX.

    +

    +

    +
    ++ + + + + + + + + + +

    x :

    integer value +

    Returns :

    integer square root. + + +
    +

    Since 0.2

    +
    +

    cogl_fixed_atan2 ()

    -
    CoglFixed           cogl_fixed_atan2                    (CoglFixed a,
    -                                                         CoglFixed b);
    +
    CoglFixed           cogl_fixed_atan2                    (CoglFixed a,
    +                                                         CoglFixed b);

    Computes the arc tangent of a / b but uses the sign of both arguments to return the angle in right quadrant.

    +

    +

    @@ -711,9 +876,11 @@

    cogl_fixed_atani ()

    -
    CoglFixed           cogl_fixed_atani                    (CoglFixed a);
    +
    CoglFixed           cogl_fixed_atani                    (CoglFixed a);

    Computes the arc tangent of a.

    +

    +

    @@ -735,9 +902,11 @@

    cogl_fixed_cos ()

    -
    CoglFixed           cogl_fixed_cos                      (CoglFixed angle);
    +
    CoglFixed           cogl_fixed_cos                      (CoglFixed angle);

    Computes the cosine of angle.

    +

    +

    @@ -757,11 +926,105 @@

    Since 1.0


    +
    +

    cogl_fixed_log2 ()

    +
    CoglFixed           cogl_fixed_log2                     (unsigned int x);
    +

    +Calculates base 2 logarithm. +

    +

    +This function is some 2.5 times faster on x86, and over 12 times faster on +fpu-less arm, than using libc log().

    +

    +

    +
    ++ + + + + + + + + + +

    x :

    value to calculate base 2 logarithm from +

    Returns :

    base 2 logarithm. + +
    +

    Since 1.0

    +
    +
    +
    +

    cogl_fixed_pow ()

    +
    unsigned int        cogl_fixed_pow                      (unsigned int x,
    +                                                         CoglFixed y);
    +

    +Calculates x to the y power.

    +

    +

    +
    ++ + + + + + + + + + + + + + +

    x :

    base +

    y :

    CoglFixed exponent +

    Returns :

    the power of x to the y + +
    +

    Since 1.0

    +
    +
    +
    +

    cogl_fixed_pow2 ()

    +
    unsigned int        cogl_fixed_pow2                     (CoglFixed x);
    +

    +Calculates 2 to the x power. +

    +

    +This function is around 11 times faster on x86, and around 22 times faster +on fpu-less arm than libc pow(2, x).

    +

    +

    +
    ++ + + + + + + + + + +

    x :

    a CoglFixed number +

    Returns :

    the power of 2 to the passed value + +
    +

    Since 1.0

    +
    +

    cogl_fixed_sin ()

    -
    CoglFixed           cogl_fixed_sin                      (CoglFixed angle);
    +
    CoglFixed           cogl_fixed_sin                      (CoglFixed angle);

    Computes the sine of angle.

    +

    +

    @@ -781,11 +1044,40 @@

    Since 1.0


    +
    +

    cogl_fixed_sqrt ()

    +
    CoglFixed           cogl_fixed_sqrt                     (CoglFixed x);
    +

    +Computes the square root of x.

    +

    +

    +
    ++ + + + + + + + + + +

    x :

    a CoglFixed number +

    Returns :

    the square root of the passed value, in floating point + notation + +
    +

    Since 1.0

    +
    +

    cogl_fixed_tan ()

    -
    CoglFixed           cogl_fixed_tan                      (CoglFixed angle);
    +
    CoglFixed           cogl_fixed_tan                      (CoglFixed angle);

    Computes the tangent of angle.

    +

    +

    @@ -812,12 +1104,169 @@

    Integer representation of an angle such that 1024 corresponds to full circle (i.e., 2 * pi).

    +

    +

    +

    Since 1.0

    + +
    +
    +

    COGL_ANGLE_FROM_DEG()

    +
    #define COGL_ANGLE_FROM_DEG(x)  (COGL_FLOAT_TO_INT (((float)(x) * 1024.0f) / 360.0f))
    +
    +

    +Converts an angle in degrees into a CoglAngle.

    +

    +

    +
    ++ + + + +

    x :

    an angle in degrees in floating point notation +
    +

    Since 1.0

    +
    +
    +
    +

    COGL_ANGLE_FROM_DEGX()

    +
    #define COGL_ANGLE_FROM_DEGX(x) (COGL_FIXED_TO_INT ((((x) / 360) * 1024) + COGL_FIXED_0_5))
    +
    +

    +Converts an angle in degrees into a CoglAngle.

    +

    +

    +
    ++ + + + +

    x :

    an angle in degrees in fixed point notation +
    +

    Since 1.0

    +
    +
    +
    +

    COGL_ANGLE_TO_DEG()

    +
    #define COGL_ANGLE_TO_DEG(x)    (((float)(x) * 360.0) / 1024.0)
    +
    +

    +Converts a CoglAngle into an angle in degrees, using floatint point +notation.

    +

    +

    +
    ++ + + + +

    x :

    a CoglAngle +
    +

    Since 1.0

    +
    +
    +
    +

    COGL_ANGLE_TO_DEGX()

    +
    #define COGL_ANGLE_TO_DEGX(x)   (COGL_FIXED_FROM_INT ((x) * 45) / 128)
    +
    +

    +Converts a CoglAngle into an angle in degrees, using fixed point notation

    +

    +

    +
    ++ + + + +

    x :

    a CoglAngle +
    +

    Since 1.0

    +
    +
    +
    +

    cogl_angle_cos ()

    +
    CoglFixed           cogl_angle_cos                      (CoglAngle angle);
    +

    +Computes the cosine of angle

    +

    +

    +
    ++ + + + + + + + + + +

    angle :

    an angle expressed using CoglAngle +

    Returns :

    the cosine of the passed angle + +
    +

    Since 1.0

    +
    +
    +
    +

    cogl_angle_sin ()

    +
    CoglFixed           cogl_angle_sin                      (CoglAngle angle);
    +

    +Computes the sine of angle

    +

    +

    +
    ++ + + + + + + + + + +

    angle :

    an angle expressed using CoglAngle +

    Returns :

    the sine of the passed angle + +
    +

    Since 1.0

    +
    +
    +
    +

    cogl_angle_tan ()

    +
    CoglFixed           cogl_angle_tan                      (CoglAngle angle);
    +

    +Computes the tangent of angle

    +

    +

    +
    ++ + + + + + + + + + +

    angle :

    an angle expressed using CoglAngle +

    Returns :

    the tangent of the passed angle + +

    Since 1.0

    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/cogl/html/ix04.html +++ clutter-1.0-1.2.4/doc/reference/cogl/html/ix04.html @@ -8,7 +8,7 @@ - + @@ -20,53 +20,43 @@ - - + - - - +

    -Index of new symbols in 1.0

    -

    A

    +Index of new symbols in 1.0
    +
    + +
    +

    B

    +
    cogl_begin_gl
    cogl_bitmap_get_size_from_file
    @@ -75,11 +65,15 @@
    CoglBlendStringError
    -
    COGL_BLEND_STRING_ERROR
    +
    COGL_BLEND_STRING_ERROR
    CoglBufferBit
    -

    C

    +
    +
    + + + + +
    +

    I

    +
    cogl_is_bitmap
    cogl_is_vertex_buffer
    -

    M

    +
    +
    + +
    +

    O

    +
    cogl_ortho
    -

    P

    +
    +
    + + + + + +
    +
    + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/cogl/html/cogl-Buffers.html +++ clutter-1.0-1.2.4/doc/reference/cogl/html/cogl-Buffers.html @@ -8,7 +8,7 @@ - + @@ -30,8 +30,8 @@ Top -  |  - Description +  |  + Description
    @@ -49,40 +49,55 @@

    Synopsis

    -
    gboolean            cogl_is_buffer                      (CoglHandle handle);
    -unsigned int        cogl_buffer_get_size                (CoglHandle handle);
    +
    +gboolean            cogl_is_buffer                      (CoglHandle handle);
    +unsigned int        cogl_buffer_get_size                (CoglHandle handle);
     enum                CoglBufferUsageHint;
    -void                cogl_buffer_set_usage_hint          (CoglHandle handle,
    -                                                         CoglBufferUsageHint hint);
    -CoglBufferUsageHint  cogl_buffer_get_usage_hint         (CoglHandle handle);
    +void                cogl_buffer_set_usage_hint          (CoglHandle handle,
    +                                                         CoglBufferUsageHint hint);
    +CoglBufferUsageHint  cogl_buffer_get_usage_hint         (CoglHandle handle);
     enum                CoglBufferUpdateHint;
    -void                cogl_buffer_set_update_hint         (CoglHandle handle,
    -                                                         CoglBufferUpdateHint hint);
    -CoglBufferUpdateHint  cogl_buffer_get_update_hint       (CoglHandle handle);
    +void                cogl_buffer_set_update_hint         (CoglHandle handle,
    +                                                         CoglBufferUpdateHint hint);
    +CoglBufferUpdateHint  cogl_buffer_get_update_hint       (CoglHandle handle);
     enum                CoglBufferAccess;
    -guint8 *            cogl_buffer_map                     (CoglHandle handle,
    -                                                         CoglBufferAccess access);
    -void                cogl_buffer_unmap                   (CoglHandle handle);
    -gboolean            cogl_buffer_set_data                (CoglHandle handle,
    -                                                         gsize offset,
    -                                                         const guint8 *data,
    -                                                         gsize size);
    -
    -CoglHandle          cogl_pixel_buffer_new               (unsigned int size);
    -CoglHandle          cogl_pixel_buffer_new_for_size      (unsigned int width,
    -                                                         unsigned int height,
    -                                                         CoglPixelFormat format,
    -                                                         unsigned int *stride);
    -gboolean            cogl_is_pixel_buffer                (CoglHandle handle);
    -
    -CoglHandle          cogl_texture_new_from_buffer        (CoglHandle buffer,
    -                                                         unsigned int width,
    -                                                         unsigned int height,
    -                                                         CoglTextureFlags flags,
    -                                                         CoglPixelFormat format,
    -                                                         CoglPixelFormat internal_format,
    -                                                         unsigned int rowstride,
    -                                                         unsigned int offset);
    +guint8 *            cogl_buffer_map                     (CoglHandle handle,
    +                                                         CoglBufferAccess access);
    +void                cogl_buffer_unmap                   (CoglHandle handle);
    +gboolean            cogl_buffer_set_data                (CoglHandle handle,
    +                                                         gsize offset,
    +                                                         const guint8 *data,
    +                                                         gsize size);
    +
    +CoglHandle          cogl_pixel_buffer_new               (unsigned int size);
    +CoglHandle          cogl_pixel_buffer_new_for_size      (unsigned int width,
    +                                                         unsigned int height,
    +                                                         CoglPixelFormat format,
    +                                                         unsigned int *stride);
    +gboolean            cogl_is_pixel_buffer                (CoglHandle handle);
    +
    +CoglHandle          cogl_texture_new_from_buffer        (CoglHandle buffer,
    +                                                         unsigned int width,
    +                                                         unsigned int height,
    +                                                         CoglTextureFlags flags,
    +                                                         CoglPixelFormat format,
    +                                                         CoglPixelFormat internal_format,
    +                                                         unsigned int rowstride,
    +                                                         unsigned int offset);
     
    @@ -90,14 +105,20 @@

    COGL allows the creation and the manipulation of buffers. If the underlying OpenGL implementation allows it, COGL will use Pixel Buffer Objects.

    +

    +

    Details

    cogl_is_buffer ()

    -
    gboolean            cogl_is_buffer                      (CoglHandle handle);
    +
    gboolean            cogl_is_buffer                      (CoglHandle handle);

    Checks whether handle is a buffer handle.

    +

    +

    @@ -108,7 +129,7 @@ - @@ -120,9 +141,11 @@

    cogl_buffer_get_size ()

    -
    unsigned int        cogl_buffer_get_size                (CoglHandle handle);
    +
    unsigned int        cogl_buffer_get_size                (CoglHandle handle);

    Retrieves the size of buffer

    +

    +

    Returns :

    TRUE if the handle is a CoglBuffer, and FALSE otherwise + TRUE if the handle is a CoglBuffer, and FALSE otherwise
    @@ -152,10 +175,12 @@

    The usage hint on a buffer allows the user to give some clue on how the buffer will be used.

    +

    +

    - + @@ -167,11 +192,13 @@

    cogl_buffer_set_usage_hint ()

    -
    void                cogl_buffer_set_usage_hint          (CoglHandle handle,
    -                                                         CoglBufferUsageHint hint);
    +
    void                cogl_buffer_set_usage_hint          (CoglHandle handle,
    +                                                         CoglBufferUsageHint hint);

    Sets the usage hint on a buffer. See CoglBufferUsageHint for a description of the available hints.

    +

    +

    COGL_BUFFER_USAGE_HINT_TEXTURE

    COGL_BUFFER_USAGE_HINT_TEXTURE

    the buffer will be used as a source data for a texture
    @@ -193,9 +220,11 @@

    cogl_buffer_get_usage_hint ()

    -
    CoglBufferUsageHint  cogl_buffer_get_usage_hint         (CoglHandle handle);
    +
    CoglBufferUsageHint  cogl_buffer_get_usage_hint         (CoglHandle handle);

    Retrieves the usage hint set using cogl_buffer_set_usage_hint()

    +

    +

    @@ -227,21 +256,23 @@

    The update hint on a buffer allows the user to give some detail on how often the buffer data is going to be updated.

    +

    +

    - + - + - + @@ -254,11 +285,13 @@

    cogl_buffer_set_update_hint ()

    -
    void                cogl_buffer_set_update_hint         (CoglHandle handle,
    -                                                         CoglBufferUpdateHint hint);
    +
    void                cogl_buffer_set_update_hint         (CoglHandle handle,
    +                                                         CoglBufferUpdateHint hint);

    Sets the update hint on a buffer. See CoglBufferUpdateHint for a description of the available hints.

    +

    +

    COGL_BUFFER_UPDATE_HINT_STATIC

    COGL_BUFFER_UPDATE_HINT_STATIC

    the buffer will not change over time

    COGL_BUFFER_UPDATE_HINT_DYNAMIC

    COGL_BUFFER_UPDATE_HINT_DYNAMIC

    the buffer will change from time to time

    COGL_BUFFER_UPDATE_HINT_STREAM

    COGL_BUFFER_UPDATE_HINT_STREAM

    the buffer will be used once or a couple of times
    @@ -280,9 +313,11 @@

    cogl_buffer_get_update_hint ()

    -
    CoglBufferUpdateHint  cogl_buffer_get_update_hint       (CoglHandle handle);
    +
    CoglBufferUpdateHint  cogl_buffer_get_update_hint       (CoglHandle handle);

    Retrieves the update hints set using cogl_buffer_set_update_hint()

    +

    +

    @@ -314,21 +349,23 @@

    The access hints for cogl_buffer_set_update_hint()

    +

    +

    - + - + - + @@ -341,10 +378,14 @@

    cogl_buffer_map ()

    -
    guint8 *            cogl_buffer_map                     (CoglHandle handle,
    -                                                         CoglBufferAccess access);
    +
    guint8 *            cogl_buffer_map                     (CoglHandle handle,
    +                                                         CoglBufferAccess access);

    Maps the buffer into the application address space for direct access.

    +

    +

    COGL_BUFFER_ACCESS_READ

    COGL_BUFFER_ACCESS_READ

    the buffer will be read

    COGL_BUFFER_ACCESS_WRITE

    COGL_BUFFER_ACCESS_WRITE

    the buffer will written to

    COGL_BUFFER_ACCESS_READ_WRITE

    COGL_BUFFER_ACCESS_READ_WRITE

    the buffer will be used for both reading and writing
    @@ -360,7 +401,7 @@ - @@ -372,9 +413,11 @@

    cogl_buffer_unmap ()

    -
    void                cogl_buffer_unmap                   (CoglHandle handle);
    +
    void                cogl_buffer_unmap                   (CoglHandle handle);

    Unmaps a buffer previously mapped by cogl_buffer_map().

    +

    +

    Returns :

    A pointer to the mapped memory or NULL is the call fails + A pointer to the mapped memory or NULL is the call fails
    @@ -389,14 +432,24 @@

    cogl_buffer_set_data ()

    -
    gboolean            cogl_buffer_set_data                (CoglHandle handle,
    -                                                         gsize offset,
    -                                                         const guint8 *data,
    -                                                         gsize size);
    +
    gboolean            cogl_buffer_set_data                (CoglHandle handle,
    +                                                         gsize offset,
    +                                                         const guint8 *data,
    +                                                         gsize size);

    Updates part of the buffer with new data from data. Where to put this new data is controlled by offset and offset + data should be less than the buffer size.

    +

    +

    @@ -422,7 +475,7 @@ - @@ -434,10 +487,12 @@

    cogl_pixel_buffer_new ()

    -
    CoglHandle          cogl_pixel_buffer_new               (unsigned int size);
    +
    CoglHandle          cogl_pixel_buffer_new               (unsigned int size);

    Creates a new buffer to store pixel data. You can create a new texture from this buffer using cogl_texture_new_from_buffer().

    +

    +

    Returns :

    TRUE is the operation succeeded, FALSE otherwise + TRUE is the operation succeeded, FALSE otherwise
    @@ -449,7 +504,7 @@ @@ -461,10 +516,10 @@

    cogl_pixel_buffer_new_for_size ()

    -
    CoglHandle          cogl_pixel_buffer_new_for_size      (unsigned int width,
    -                                                         unsigned int height,
    -                                                         CoglPixelFormat format,
    -                                                         unsigned int *stride);
    +
    CoglHandle          cogl_pixel_buffer_new_for_size      (unsigned int width,
    +                                                         unsigned int height,
    +                                                         CoglPixelFormat format,
    +                                                         unsigned int *stride);

    Creates a new buffer to store pixel data.

    @@ -476,6 +531,8 @@ from it with cogl_texture_new_from_buffer(). For various reasons, such buffers are likely to have a stride larger than width * bytes_per_pixel. The user must take the stride into account when writing into it.
    +

    +

    Returns :

    a CoglHandle representing the newly created buffer or - COGL_INVALID_HANDLE on failure + COGL_INVALID_HANDLE on failure
    @@ -496,14 +553,14 @@ - @@ -515,9 +572,13 @@

    cogl_is_pixel_buffer ()

    -
    gboolean            cogl_is_pixel_buffer                (CoglHandle handle);
    +
    gboolean            cogl_is_pixel_buffer                (CoglHandle handle);

    Checks whether handle is a pixel buffer.

    +

    +

    stride :

    if not NULL the function will return the stride of the buffer + if not NULL the function will return the stride of the buffer in bytes

    Returns :

    a CoglHandle representing the newly created buffer or - COGL_INVALID_HANDLE on failure + COGL_INVALID_HANDLE on failure
    @@ -528,7 +589,7 @@ - @@ -541,18 +602,20 @@

    cogl_texture_new_from_buffer ()

    -
    CoglHandle          cogl_texture_new_from_buffer        (CoglHandle buffer,
    -                                                         unsigned int width,
    -                                                         unsigned int height,
    -                                                         CoglTextureFlags flags,
    -                                                         CoglPixelFormat format,
    -                                                         CoglPixelFormat internal_format,
    -                                                         unsigned int rowstride,
    -                                                         unsigned int offset);
    +
    CoglHandle          cogl_texture_new_from_buffer        (CoglHandle buffer,
    +                                                         unsigned int width,
    +                                                         unsigned int height,
    +                                                         CoglTextureFlags flags,
    +                                                         CoglPixelFormat format,
    +                                                         CoglPixelFormat internal_format,
    +                                                         unsigned int rowstride,
    +                                                         unsigned int offset);

    Creates a new texture using the buffer specified by handle. If the buffer has been created using cogl_pixel_buffer_new_for_size() it's possible to omit the height and width values already specified at creation time.

    +

    +

    Returns :

    TRUE if the handle is a pixel buffer, and FALSE + TRUE if the handle is a pixel buffer, and FALSE otherwise
    @@ -573,7 +636,7 @@ - @@ -584,7 +647,7 @@ - @@ -621,6 +684,6 @@ + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/cogl/html/cogl-Matrices.html +++ clutter-1.0-1.2.4/doc/reference/cogl/html/cogl-Matrices.html @@ -8,7 +8,7 @@ - + @@ -30,8 +30,8 @@

    flags :

    optional flags for the texture, or COGL_TEXTURE_NONE + optional flags for the texture, or COGL_TEXTURE_NONE

    internal_format :

    the CoglPixelFormat that will be used for storing - the buffer on the GPU. If COGL_PIXEL_FORMAT_ANY is given then a + the buffer on the GPU. If COGL_PIXEL_FORMAT_ANY is given then a premultiplied format similar to the format of the source data will be used. The default blending equations of Cogl expect premultiplied color data; the main use of passing a non-premultiplied format here @@ -607,7 +670,7 @@

    Returns :

    a CoglHandle to the new texture or COGL_INVALID_HANDLE on + a CoglHandle to the new texture or COGL_INVALID_HANDLE on failure
    Top -  |  - Description +  |  + Description
    @@ -45,53 +45,56 @@

    Synopsis

    -
                        CoglMatrix;
    -void                cogl_matrix_init_identity           (CoglMatrix *matrix);
    -void                cogl_matrix_frustum                 (CoglMatrix *matrix,
    -                                                         float left,
    -                                                         float right,
    -                                                         float bottom,
    -                                                         float top,
    -                                                         float z_near,
    -                                                         float z_far);
    -void                cogl_matrix_ortho                   (CoglMatrix *matrix,
    -                                                         float left,
    -                                                         float right,
    -                                                         float bottom,
    -                                                         float top,
    -                                                         float z_near,
    -                                                         float z_far);
    -void                cogl_matrix_perspective             (CoglMatrix *matrix,
    -                                                         float fov_y,
    -                                                         float aspect,
    -                                                         float z_near,
    -                                                         float z_far);
    -void                cogl_matrix_transform_point         (const CoglMatrix *matrix,
    -                                                         float *x,
    -                                                         float *y,
    -                                                         float *z,
    -                                                         float *w);
    -void                cogl_matrix_multiply                (CoglMatrix *result,
    -                                                         const CoglMatrix *a,
    -                                                         const CoglMatrix *b);
    -void                cogl_matrix_rotate                  (CoglMatrix *matrix,
    -                                                         float angle,
    -                                                         float x,
    -                                                         float y,
    -                                                         float z);
    -void                cogl_matrix_translate               (CoglMatrix *matrix,
    -                                                         float x,
    -                                                         float y,
    -                                                         float z);
    -void                cogl_matrix_scale                   (CoglMatrix *matrix,
    -                                                         float sx,
    -                                                         float sy,
    -                                                         float sz);
    -void                cogl_matrix_init_from_array         (CoglMatrix *matrix,
    -                                                         const float *array);
    -const float *       cogl_matrix_get_array               (const CoglMatrix *matrix);
    -gboolean            cogl_matrix_get_inverse             (const CoglMatrix *matrix,
    -                                                         CoglMatrix *inverse);
    +
    +                    CoglMatrix;
    +void                cogl_matrix_init_identity           (CoglMatrix *matrix);
    +void                cogl_matrix_frustum                 (CoglMatrix *matrix,
    +                                                         float left,
    +                                                         float right,
    +                                                         float bottom,
    +                                                         float top,
    +                                                         float z_near,
    +                                                         float z_far);
    +void                cogl_matrix_ortho                   (CoglMatrix *matrix,
    +                                                         float left,
    +                                                         float right,
    +                                                         float bottom,
    +                                                         float top,
    +                                                         float z_near,
    +                                                         float z_far);
    +void                cogl_matrix_perspective             (CoglMatrix *matrix,
    +                                                         float fov_y,
    +                                                         float aspect,
    +                                                         float z_near,
    +                                                         float z_far);
    +void                cogl_matrix_transform_point         (const CoglMatrix *matrix,
    +                                                         float *x,
    +                                                         float *y,
    +                                                         float *z,
    +                                                         float *w);
    +void                cogl_matrix_multiply                (CoglMatrix *result,
    +                                                         const CoglMatrix *a,
    +                                                         const CoglMatrix *b);
    +void                cogl_matrix_rotate                  (CoglMatrix *matrix,
    +                                                         float angle,
    +                                                         float x,
    +                                                         float y,
    +                                                         float z);
    +void                cogl_matrix_translate               (CoglMatrix *matrix,
    +                                                         float x,
    +                                                         float y,
    +                                                         float z);
    +void                cogl_matrix_scale                   (CoglMatrix *matrix,
    +                                                         float sx,
    +                                                         float sy,
    +                                                         float sz);
    +void                cogl_matrix_init_from_array         (CoglMatrix *matrix,
    +                                                         const float *array);
    +const float *       cogl_matrix_get_array               (const CoglMatrix *matrix);
    +gboolean            cogl_matrix_get_inverse             (const CoglMatrix *matrix,
    +                                                         CoglMatrix *inverse);
     
    @@ -100,6 +103,8 @@ Matrices are used in Cogl to describe affine model-view transforms, texture transforms, and projective transforms. This exposes a utility API that can be used for direct manipulation of these matrices.

    +

    +

    Details

    @@ -142,11 +147,13 @@ allows Cogl to annotate the matrices internally. Violation of this will give undefined results. If you need to initialize a matrix with a constant other than the identity matrix you can use cogl_matrix_init_from_array().
    +

    +


    cogl_matrix_init_identity ()

    -
    void                cogl_matrix_init_identity           (CoglMatrix *matrix);
    +
    void                cogl_matrix_init_identity           (CoglMatrix *matrix);

    Resets matrix to the identity matrix:

    @@ -158,6 +165,8 @@ .zx=0; .zy=0; .zz=1; .zw=0; .wx=0; .wy=0; .wz=0; .ww=1;
    +

    +

    @@ -170,15 +179,17 @@

    cogl_matrix_frustum ()

    -
    void                cogl_matrix_frustum                 (CoglMatrix *matrix,
    -                                                         float left,
    -                                                         float right,
    -                                                         float bottom,
    -                                                         float top,
    -                                                         float z_near,
    -                                                         float z_far);
    +
    void                cogl_matrix_frustum                 (CoglMatrix *matrix,
    +                                                         float left,
    +                                                         float right,
    +                                                         float bottom,
    +                                                         float top,
    +                                                         float z_near,
    +                                                         float z_far);

    Multiplies matrix by the given frustum perspective matrix.

    +

    +

    @@ -223,15 +234,17 @@

    cogl_matrix_ortho ()

    -
    void                cogl_matrix_ortho                   (CoglMatrix *matrix,
    -                                                         float left,
    -                                                         float right,
    -                                                         float bottom,
    -                                                         float top,
    -                                                         float z_near,
    -                                                         float z_far);
    +
    void                cogl_matrix_ortho                   (CoglMatrix *matrix,
    +                                                         float left,
    +                                                         float right,
    +                                                         float bottom,
    +                                                         float top,
    +                                                         float z_near,
    +                                                         float z_far);

    Multiplies matrix by a parallel projection matrix.

    +

    +

    @@ -278,11 +291,11 @@

    cogl_matrix_perspective ()

    -
    void                cogl_matrix_perspective             (CoglMatrix *matrix,
    -                                                         float fov_y,
    -                                                         float aspect,
    -                                                         float z_near,
    -                                                         float z_far);
    +
    void                cogl_matrix_perspective             (CoglMatrix *matrix,
    +                                                         float fov_y,
    +                                                         float aspect,
    +                                                         float z_near,
    +                                                         float z_far);

    Multiplies matrix by the described perspective matrix

    @@ -293,6 +306,8 @@ since that will reduce the effectiveness of depth testing since there wont be enough precision to identify the depth of objects near to each other.
    +

    +

    @@ -329,14 +344,16 @@

    cogl_matrix_transform_point ()

    -
    void                cogl_matrix_transform_point         (const CoglMatrix *matrix,
    -                                                         float *x,
    -                                                         float *y,
    -                                                         float *z,
    -                                                         float *w);
    +
    void                cogl_matrix_transform_point         (const CoglMatrix *matrix,
    +                                                         float *x,
    +                                                         float *y,
    +                                                         float *z,
    +                                                         float *w);

    Transforms a point whos position is given and returned as four float components.

    +

    +

    @@ -367,12 +384,14 @@

    cogl_matrix_multiply ()

    -
    void                cogl_matrix_multiply                (CoglMatrix *result,
    -                                                         const CoglMatrix *a,
    -                                                         const CoglMatrix *b);
    +
    void                cogl_matrix_multiply                (CoglMatrix *result,
    +                                                         const CoglMatrix *a,
    +                                                         const CoglMatrix *b);

    Multiplies the two supplied matrices together and stores the resulting matrix inside result

    +

    +

    @@ -397,14 +416,16 @@

    cogl_matrix_rotate ()

    -
    void                cogl_matrix_rotate                  (CoglMatrix *matrix,
    -                                                         float angle,
    -                                                         float x,
    -                                                         float y,
    -                                                         float z);
    +
    void                cogl_matrix_rotate                  (CoglMatrix *matrix,
    +                                                         float angle,
    +                                                         float x,
    +                                                         float y,
    +                                                         float z);

    Multiplies matrix with a rotation matrix that applies a rotation of angle degrees around the specified 3D vector.

    +

    +

    @@ -439,13 +460,15 @@

    cogl_matrix_translate ()

    -
    void                cogl_matrix_translate               (CoglMatrix *matrix,
    -                                                         float x,
    -                                                         float y,
    -                                                         float z);
    +
    void                cogl_matrix_translate               (CoglMatrix *matrix,
    +                                                         float x,
    +                                                         float y,
    +                                                         float z);

    Multiplies matrix with a transform matrix that translates along the X, Y and Z axis.

    +

    +

    @@ -475,13 +498,15 @@

    cogl_matrix_scale ()

    -
    void                cogl_matrix_scale                   (CoglMatrix *matrix,
    -                                                         float sx,
    -                                                         float sy,
    -                                                         float sz);
    +
    void                cogl_matrix_scale                   (CoglMatrix *matrix,
    +                                                         float sx,
    +                                                         float sy,
    +                                                         float sz);

    Multiplies matrix with a transform matrix that scales along the X, Y and Z axis.

    +

    +

    @@ -511,10 +536,12 @@

    cogl_matrix_init_from_array ()

    -
    void                cogl_matrix_init_from_array         (CoglMatrix *matrix,
    -                                                         const float *array);
    +
    void                cogl_matrix_init_from_array         (CoglMatrix *matrix,
    +                                                         const float *array);

    Initializes matrix with the contents of array

    +

    +

    @@ -534,9 +561,11 @@

    cogl_matrix_get_array ()

    -
    const float *       cogl_matrix_get_array               (const CoglMatrix *matrix);
    +
    const float *       cogl_matrix_get_array               (const CoglMatrix *matrix);

    Casts matrix to a float array which can be directly passed to OpenGL.

    +

    +

    @@ -556,8 +585,10 @@

    cogl_matrix_get_inverse ()

    -
    gboolean            cogl_matrix_get_inverse             (const CoglMatrix *matrix,
    -                                                         CoglMatrix *inverse);
    +
    gboolean            cogl_matrix_get_inverse             (const CoglMatrix *matrix,
    +                                                         CoglMatrix *inverse);

    Gets the inverse transform of a given matrix and uses it to initialize a new CoglMatrix. @@ -570,6 +601,8 @@ technically save a copy of the inverse transform within the given CoglMatrix so that subsequent requests for the inverse transform may avoid costly inversion calculations.

    +

    +

    @@ -584,7 +617,7 @@ -

    Returns :

    TRUE if the inverse was successfully calculated or FALSE + TRUE if the inverse was successfully calculated or FALSE for degenerate transformations that can't be inverted (in this case the inverse matrix will simply be initialized with the identity matrix) @@ -598,6 +631,6 @@ + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/cogl/html/ix02.html +++ clutter-1.0-1.2.4/doc/reference/cogl/html/ix02.html @@ -8,7 +8,7 @@ - + @@ -20,34 +20,20 @@ - - + - - - +

    -Index of deprecated symbols

    -

    C

    +Index of deprecated symbols
    +
    + + + + + + + +
    +
    + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/cogl/html/cogl-Shaders-and-Programmable-Pipeline.html +++ clutter-1.0-1.2.4/doc/reference/cogl/html/cogl-Shaders-and-Programmable-Pipeline.html @@ -8,7 +8,7 @@ - + @@ -30,8 +30,8 @@ Top -  |  - Description +  |  + Description
    @@ -45,45 +45,54 @@

    Synopsis

    -
    enum                CoglShaderType;
    -CoglHandle          cogl_create_shader                  (CoglShaderType shader_type);
    -CoglHandle          cogl_shader_ref                     (CoglHandle handle);
    -void                cogl_shader_unref                   (CoglHandle handle);
    -gboolean            cogl_is_shader                      (CoglHandle handle);
    -void                cogl_shader_source                  (CoglHandle shader,
    -                                                         const char *source);
    -void                cogl_shader_compile                 (CoglHandle handle);
    -char *              cogl_shader_get_info_log            (CoglHandle handle);
    -CoglShaderType      cogl_shader_get_type                (CoglHandle handle);
    -gboolean            cogl_shader_is_compiled             (CoglHandle handle);
    +
    +enum                CoglShaderType;
    +CoglHandle          cogl_create_shader                  (CoglShaderType shader_type);
    +CoglHandle          cogl_shader_ref                     (CoglHandle handle);
    +void                cogl_shader_unref                   (CoglHandle handle);
    +gboolean            cogl_is_shader                      (CoglHandle handle);
    +void                cogl_shader_source                  (CoglHandle shader,
    +                                                         const char *source);
    +void                cogl_shader_compile                 (CoglHandle handle);
    +char *              cogl_shader_get_info_log            (CoglHandle handle);
    +CoglShaderType      cogl_shader_get_type                (CoglHandle handle);
    +gboolean            cogl_shader_is_compiled             (CoglHandle handle);
     
    -CoglHandle          cogl_create_program                 (void);
    -CoglHandle          cogl_program_ref                    (CoglHandle handle);
    -void                cogl_program_unref                  (CoglHandle handle);
    -gboolean            cogl_is_program                     (CoglHandle handle);
    -void                cogl_program_attach_shader          (CoglHandle program_handle,
    -                                                         CoglHandle shader_handle);
    -void                cogl_program_link                   (CoglHandle handle);
    -void                cogl_program_use                    (CoglHandle handle);
    -int                 cogl_program_get_uniform_location   (CoglHandle handle,
    -                                                         const char *uniform_name);
    -void                cogl_program_uniform_1f             (int uniform_no,
    -                                                         float value);
    -void                cogl_program_uniform_1i             (int uniform_no,
    -                                                         int value);
    -void                cogl_program_uniform_float          (int uniform_no,
    -                                                         int size,
    -                                                         int count,
    -                                                         const GLfloat *value);
    -void                cogl_program_uniform_int            (int uniform_no,
    -                                                         int size,
    -                                                         int count,
    -                                                         const int *value);
    -void                cogl_program_uniform_matrix         (int uniform_no,
    -                                                         int size,
    -                                                         int count,
    -                                                         gboolean transpose,
    -                                                         const float *value);
    +CoglHandle          cogl_create_program                 (void);
    +CoglHandle          cogl_program_ref                    (CoglHandle handle);
    +void                cogl_program_unref                  (CoglHandle handle);
    +gboolean            cogl_is_program                     (CoglHandle handle);
    +void                cogl_program_attach_shader          (CoglHandle program_handle,
    +                                                         CoglHandle shader_handle);
    +void                cogl_program_link                   (CoglHandle handle);
    +void                cogl_program_use                    (CoglHandle handle);
    +int                 cogl_program_get_uniform_location   (CoglHandle handle,
    +                                                         const char *uniform_name);
    +void                cogl_program_uniform_1f             (int uniform_no,
    +                                                         float value);
    +void                cogl_program_uniform_1i             (int uniform_no,
    +                                                         int value);
    +void                cogl_program_uniform_float          (int uniform_no,
    +                                                         int size,
    +                                                         int count,
    +                                                         const GLfloat *value);
    +void                cogl_program_uniform_int            (int uniform_no,
    +                                                         int size,
    +                                                         int count,
    +                                                         const int *value);
    +void                cogl_program_uniform_matrix         (int uniform_no,
    +                                                         int size,
    +                                                         int count,
    +                                                         gboolean transpose,
    +                                                         const float *value);
     
    @@ -94,6 +103,8 @@

    The only supported format is GLSL shaders.

    +

    +

    Details

    @@ -106,16 +117,18 @@

    Types of shaders

    +

    +

    - + - + @@ -126,10 +139,12 @@

    cogl_create_shader ()

    -
    CoglHandle          cogl_create_shader                  (CoglShaderType shader_type);
    +
    CoglHandle          cogl_create_shader                  (CoglShaderType shader_type);

    Create a new shader handle, use cogl_shader_source to set the source code to be used on it.

    +

    +

    COGL_SHADER_TYPE_VERTEX

    COGL_SHADER_TYPE_VERTEX

    A program for proccessing vertices

    COGL_SHADER_TYPE_FRAGMENT

    COGL_SHADER_TYPE_FRAGMENT

    A program for processing fragments
    @@ -149,13 +164,15 @@

    cogl_shader_ref ()

    -
    CoglHandle          cogl_shader_ref                     (CoglHandle handle);
    +
    CoglHandle          cogl_shader_ref                     (CoglHandle handle);

    Warning

    cogl_shader_ref is deprecated and should not be used in newly-written code.

    Add an extra reference to a shader.

    +

    +

    @@ -175,7 +192,7 @@

    cogl_shader_unref ()

    -
    void                cogl_shader_unref                   (CoglHandle handle);
    +
    void                cogl_shader_unref                   (CoglHandle handle);

    Warning

    cogl_shader_unref is deprecated and should not be used in newly-written code.

    @@ -183,6 +200,8 @@

    Removes a reference to a shader. If it was the last reference the shader object will be destroyed.

    +

    +

    @@ -195,9 +214,13 @@

    cogl_is_shader ()

    -
    gboolean            cogl_is_shader                      (CoglHandle handle);
    +
    gboolean            cogl_is_shader                      (CoglHandle handle);

    Gets whether the given handle references an existing shader object.

    +

    +

    @@ -208,8 +231,8 @@ - @@ -218,11 +241,13 @@

    cogl_shader_source ()

    -
    void                cogl_shader_source                  (CoglHandle shader,
    -                                                         const char *source);
    +
    void                cogl_shader_source                  (CoglHandle shader,
    +                                                         const char *source);

    Replaces the current GLSL source associated with a shader with a new one.

    +

    +

    Returns :

    TRUE if the handle references a shader, - FALSE otherwise + TRUE if the handle references a shader, + FALSE otherwise
    @@ -242,10 +267,12 @@

    cogl_shader_compile ()

    -
    void                cogl_shader_compile                 (CoglHandle handle);
    +
    void                cogl_shader_compile                 (CoglHandle handle);

    Compiles the shader, no return value, but the shader is now ready for linking into a program.

    +

    +

    @@ -258,12 +285,14 @@

    cogl_shader_get_info_log ()

    -
    char *              cogl_shader_get_info_log            (CoglHandle handle);
    +
    char *              cogl_shader_get_info_log            (CoglHandle handle);

    Retrieves the information log for a coglobject, can be used in conjunction with cogl_shader_get_parameteriv() to retrieve the compiler warnings/error messages that caused a shader to not compile correctly, mainly useful for debugging purposes.

    +

    +

    @@ -275,7 +304,9 @@ @@ -284,9 +315,11 @@

    cogl_shader_get_type ()

    -
    CoglShaderType      cogl_shader_get_type                (CoglHandle handle);
    +
    CoglShaderType      cogl_shader_get_type                (CoglHandle handle);

    Retrieves the type of a shader CoglHandle

    +

    +

    Returns :

    a newly allocated string containing the info log. Use - g_free() to free it + g_free() to free it
    @@ -297,8 +330,8 @@ - @@ -307,9 +340,13 @@

    cogl_shader_is_compiled ()

    -
    gboolean            cogl_shader_is_compiled             (CoglHandle handle);
    +
    gboolean            cogl_shader_is_compiled             (CoglHandle handle);

    Retrieves whether a shader CoglHandle has been compiled

    +

    +

    Returns :

    COGL_SHADER_TYPE_VERTEX if the shader is a vertex processor - or COGL_SHADER_TYPE_FRAGMENT if the shader is a frament processor + COGL_SHADER_TYPE_VERTEX if the shader is a vertex processor + or COGL_SHADER_TYPE_FRAGMENT if the shader is a frament processor
    @@ -320,7 +357,7 @@ - @@ -329,10 +366,12 @@

    cogl_create_program ()

    -
    CoglHandle          cogl_create_program                 (void);
    +
    CoglHandle          cogl_create_program                 (void);

    Create a new cogl program object that can be used to replace parts of the GL rendering pipeline with custom code.

    +

    +

    Returns :

    TRUE if the shader object has sucessfully be compiled + TRUE if the shader object has sucessfully be compiled
    @@ -345,9 +384,11 @@

    cogl_program_ref ()

    -
    CoglHandle          cogl_program_ref                    (CoglHandle handle);
    +
    CoglHandle          cogl_program_ref                    (CoglHandle handle);

    Add an extra reference to a program.

    +

    +

    @@ -367,10 +408,12 @@

    cogl_program_unref ()

    -
    void                cogl_program_unref                  (CoglHandle handle);
    +
    void                cogl_program_unref                  (CoglHandle handle);

    Removes a reference to a program. If it was the last reference the program object will be destroyed.

    +

    +

    @@ -383,9 +426,13 @@

    cogl_is_program ()

    -
    gboolean            cogl_is_program                     (CoglHandle handle);
    +
    gboolean            cogl_is_program                     (CoglHandle handle);

    Gets whether the given handle references an existing program object.

    +

    +

    @@ -396,8 +443,8 @@ - @@ -406,11 +453,13 @@

    cogl_program_attach_shader ()

    -
    void                cogl_program_attach_shader          (CoglHandle program_handle,
    -                                                         CoglHandle shader_handle);
    +
    void                cogl_program_attach_shader          (CoglHandle program_handle,
    +                                                         CoglHandle shader_handle);

    Attaches a shader to a program object, a program can have one vertex shader and one fragment shader attached.

    +

    +

    Returns :

    TRUE if the handle references a program, - FALSE otherwise + TRUE if the handle references a program, + FALSE otherwise
    @@ -430,9 +479,11 @@

    cogl_program_link ()

    -
    void                cogl_program_link                   (CoglHandle handle);
    +
    void                cogl_program_link                   (CoglHandle handle);

    Links a program making it ready for use.

    +

    +

    @@ -445,16 +496,18 @@

    cogl_program_use ()

    -
    void                cogl_program_use                    (CoglHandle handle);
    +
    void                cogl_program_use                    (CoglHandle handle);

    Activate a specific shader program replacing that part of the GL -rendering pipeline, if passed in COGL_INVALID_HANDLE the default +rendering pipeline, if passed in COGL_INVALID_HANDLE the default behavior of GL is reinstated.

    +

    +

    -

    handle :

    a CoglHandle for a shader program or COGL_INVALID_HANDLE. + a CoglHandle for a shader program or COGL_INVALID_HANDLE.
    @@ -462,12 +515,14 @@

    cogl_program_get_uniform_location ()

    -
    int                 cogl_program_get_uniform_location   (CoglHandle handle,
    -                                                         const char *uniform_name);
    +
    int                 cogl_program_get_uniform_location   (CoglHandle handle,
    +                                                         const char *uniform_name);

    Retrieve the location (offset) of a uniform variable in a shader program, a uniform is a variable that is constant for all vertices/fragments for a shader object and is possible to modify as an external parameter.

    +

    +

    @@ -494,11 +549,13 @@

    cogl_program_uniform_1f ()

    -
    void                cogl_program_uniform_1f             (int uniform_no,
    -                                                         float value);
    +
    void                cogl_program_uniform_1f             (int uniform_no,
    +                                                         float value);

    Changes the value of a floating point uniform in the currently used (see cogl_program_use()) shader program.

    +

    +

    @@ -518,11 +575,13 @@

    cogl_program_uniform_1i ()

    -
    void                cogl_program_uniform_1i             (int uniform_no,
    -                                                         int value);
    +
    void                cogl_program_uniform_1i             (int uniform_no,
    +                                                         int value);

    Changes the value of an integer uniform in the currently used (see cogl_program_use()) shader program.

    +

    +

    @@ -542,13 +601,15 @@

    cogl_program_uniform_float ()

    -
    void                cogl_program_uniform_float          (int uniform_no,
    -                                                         int size,
    -                                                         int count,
    -                                                         const GLfloat *value);
    +
    void                cogl_program_uniform_float          (int uniform_no,
    +                                                         int size,
    +                                                         int count,
    +                                                         const GLfloat *value);

    Changes the value of a float vector uniform, or uniform array in the currently used (see cogl_program_use()) shader program.

    +

    +

    @@ -577,13 +638,15 @@

    cogl_program_uniform_int ()

    -
    void                cogl_program_uniform_int            (int uniform_no,
    -                                                         int size,
    -                                                         int count,
    -                                                         const int *value);
    +
    void                cogl_program_uniform_int            (int uniform_no,
    +                                                         int size,
    +                                                         int count,
    +                                                         const int *value);

    Changes the value of a int vector uniform, or uniform array in the currently used (see cogl_program_use()) shader program.

    +

    +

    @@ -612,15 +675,19 @@

    cogl_program_uniform_matrix ()

    -
    void                cogl_program_uniform_matrix         (int uniform_no,
    -                                                         int size,
    -                                                         int count,
    -                                                         gboolean transpose,
    -                                                         const float *value);
    +
    void                cogl_program_uniform_matrix         (int uniform_no,
    +                                                         int size,
    +                                                         int count,
    +                                                         gboolean transpose,
    +                                                         const float *value);

    Changes the value of a matrix uniform, or uniform array in the currently used (see cogl_program_use()) shader program. The size parameter is used to determine the square size of the matrix.

    +

    +

    @@ -655,6 +722,6 @@ + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/cogl/html/license.html +++ clutter-1.0-1.2.4/doc/reference/cogl/html/license.html @@ -7,7 +7,7 @@ - + @@ -61,6 +61,6 @@ + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/cogl/html/cogl-General-API.html +++ clutter-1.0-1.2.4/doc/reference/cogl/html/cogl-General-API.html @@ -8,7 +8,7 @@ - + @@ -30,8 +30,8 @@
    Top -  |  - Description +  |  + Description
    @@ -45,125 +45,154 @@

    Synopsis

    -
    #define             COGL_INVALID_HANDLE
    +
    +#define             COGL_INVALID_HANDLE
     typedef             CoglHandle;
    -CoglHandle          cogl_handle_ref                     (CoglHandle handle);
    -void                cogl_handle_unref                   (CoglHandle Handle);
    +CoglHandle          cogl_handle_ref                     (CoglHandle handle);
    +void                cogl_handle_unref                   (CoglHandle Handle);
     
    -void                (*CoglFuncPtr)                      (void);
    +void                (*CoglFuncPtr)                      (void);
     enum                CoglPixelFormat;
     enum                CoglBufferTarget;
     enum                CoglBufferBit;
     enum                CoglAttributeType;
     
     enum                CoglFeatureFlags;
    -CoglFeatureFlags    cogl_get_features                   (void);
    -gboolean            cogl_features_available             (CoglFeatureFlags features);
    -gboolean            cogl_check_extension                (const char *name,
    -                                                         const char *ext);
    -CoglFuncPtr         cogl_get_proc_address               (const char *name);
    -GOptionGroup *      cogl_get_option_group               (void);
    +CoglFeatureFlags    cogl_get_features                   (void);
    +gboolean            cogl_features_available             (CoglFeatureFlags features);
    +gboolean            cogl_check_extension                (const char *name,
    +                                                         const char *ext);
    +CoglFuncPtr         cogl_get_proc_address               (const char *name);
    +GOptionGroup *      cogl_get_option_group               (void);
     
    -void                cogl_push_matrix                    (void);
    -void                cogl_pop_matrix                     (void);
    -void                cogl_scale                          (float x,
    -                                                         float y,
    -                                                         float z);
    -void                cogl_translate                      (float x,
    -                                                         float y,
    -                                                         float z);
    -void                cogl_rotate                         (float angle,
    -                                                         float x,
    -                                                         float y,
    -                                                         float z);
    -void                cogl_frustum                        (float left,
    -                                                         float right,
    -                                                         float bottom,
    -                                                         float top,
    -                                                         float z_near,
    -                                                         float z_far);
    -void                cogl_perspective                    (float fovy,
    -                                                         float aspect,
    -                                                         float z_near,
    -                                                         float z_far);
    -void                cogl_ortho                          (float left,
    -                                                         float right,
    -                                                         float bottom,
    -                                                         float top,
    -                                                         float near,
    -                                                         float far);
    +void                cogl_push_matrix                    (void);
    +void                cogl_pop_matrix                     (void);
    +void                cogl_scale                          (float x,
    +                                                         float y,
    +                                                         float z);
    +void                cogl_translate                      (float x,
    +                                                         float y,
    +                                                         float z);
    +void                cogl_rotate                         (float angle,
    +                                                         float x,
    +                                                         float y,
    +                                                         float z);
    +void                cogl_frustum                        (float left,
    +                                                         float right,
    +                                                         float bottom,
    +                                                         float top,
    +                                                         float z_near,
    +                                                         float z_far);
    +void                cogl_perspective                    (float fovy,
    +                                                         float aspect,
    +                                                         float z_near,
    +                                                         float z_far);
    +void                cogl_ortho                          (float left,
    +                                                         float right,
    +                                                         float bottom,
    +                                                         float top,
    +                                                         float near,
    +                                                         float far);
     
    -void                cogl_get_modelview_matrix           (CoglMatrix *matrix);
    -void                cogl_set_modelview_matrix           (CoglMatrix *matrix);
    -void                cogl_get_projection_matrix          (CoglMatrix *matrix);
    -void                cogl_set_projection_matrix          (CoglMatrix *matrix);
    -void                cogl_viewport                       (unsigned int width,
    -                                                         unsigned int height);
    -void                cogl_set_viewport                   (int x,
    -                                                         int y,
    -                                                         int width,
    -                                                         int height);
    -void                cogl_get_viewport                   (float v[4]);
    +void                cogl_get_modelview_matrix           (CoglMatrix *matrix);
    +void                cogl_set_modelview_matrix           (CoglMatrix *matrix);
    +void                cogl_get_projection_matrix          (CoglMatrix *matrix);
    +void                cogl_set_projection_matrix          (CoglMatrix *matrix);
    +void                cogl_viewport                       (unsigned int width,
    +                                                         unsigned int height);
    +void                cogl_set_viewport                   (int x,
    +                                                         int y,
    +                                                         int width,
    +                                                         int height);
    +void                cogl_get_viewport                   (float v[4]);
     
    -void                cogl_clear                          (const CoglColor *color,
    -                                                         unsigned long  buffers);
    -void                cogl_get_bitmasks                   (int *red,
    -                                                         int *green,
    -                                                         int *blue,
    -                                                         int *alpha);
    -void                cogl_set_depth_test_enabled         (gboolean setting);
    -gboolean            cogl_get_depth_test_enabled         (void);
    -void                cogl_set_backface_culling_enabled   (gboolean setting);
    -gboolean            cogl_get_backface_culling_enabled   (void);
    +void                cogl_clear                          (const CoglColor *color,
    +                                                         unsigned long  buffers);
    +void                cogl_get_bitmasks                   (int *red,
    +                                                         int *green,
    +                                                         int *blue,
    +                                                         int *alpha);
    +void                cogl_set_depth_test_enabled         (gboolean setting);
    +gboolean            cogl_get_depth_test_enabled         (void);
    +void                cogl_set_backface_culling_enabled   (gboolean setting);
    +gboolean            cogl_get_backface_culling_enabled   (void);
     
     enum                CoglFogMode;
    -void                cogl_set_fog                        (const CoglColor *fog_color,
    -                                                         CoglFogMode mode,
    -                                                         float density,
    -                                                         float z_near,
    -                                                         float z_far);
    -void                cogl_disable_fog                    (void);
    +void                cogl_set_fog                        (const CoglColor *fog_color,
    +                                                         CoglFogMode mode,
    +                                                         float density,
    +                                                         float z_near,
    +                                                         float z_far);
    +void                cogl_disable_fog                    (void);
     
    -void                cogl_set_source                     (CoglHandle material);
    -void                cogl_set_source_color               (const CoglColor *color);
    -void                cogl_set_source_color4ub            (guint8 red,
    -                                                         guint8 green,
    -                                                         guint8 blue,
    -                                                         guint8 alpha);
    -void                cogl_set_source_color4f             (float red,
    -                                                         float green,
    -                                                         float blue,
    -                                                         float alpha);
    -void                cogl_set_source_texture             (CoglHandle texture_handle);
    +void                cogl_set_source                     (CoglHandle material);
    +void                cogl_set_source_color               (const CoglColor *color);
    +void                cogl_set_source_color4ub            (guint8 red,
    +                                                         guint8 green,
    +                                                         guint8 blue,
    +                                                         guint8 alpha);
    +void                cogl_set_source_color4f             (float red,
    +                                                         float green,
    +                                                         float blue,
    +                                                         float alpha);
    +void                cogl_set_source_texture             (CoglHandle texture_handle);
     
     enum                CoglReadPixelsFlags;
    -void                cogl_read_pixels                    (int x,
    -                                                         int y,
    -                                                         int width,
    -                                                         int height,
    -                                                         CoglReadPixelsFlags source,
    -                                                         CoglPixelFormat format,
    -                                                         guint8 *pixels);
    +void                cogl_read_pixels                    (int x,
    +                                                         int y,
    +                                                         int width,
    +                                                         int height,
    +                                                         CoglReadPixelsFlags source,
    +                                                         CoglPixelFormat format,
    +                                                         guint8 *pixels);
     
    -void                cogl_flush                          (void);
    -void                cogl_begin_gl                       (void);
    -void                cogl_end_gl                         (void);
    +void                cogl_flush                          (void);
    +void                cogl_begin_gl                       (void);
    +void                cogl_end_gl                         (void);
     

    Description

    General utility functions for COGL.

    +

    +

    Details

    -

    COGL_INVALID_HANDLE

    +

    COGL_INVALID_HANDLE

    #define COGL_INVALID_HANDLE NULL
     

    A COGL handle that is not valid, used for unitialized handles as well as error conditions.

    +

    +


    @@ -173,13 +202,17 @@

    Type used for storing references to cogl objects, the CoglHandle is a fully opaque type without any public data members.

    +

    +


    cogl_handle_ref ()

    -
    CoglHandle          cogl_handle_ref                     (CoglHandle handle);
    +
    CoglHandle          cogl_handle_ref                     (CoglHandle handle);

    Increases the reference count of handle by 1

    +

    +

    @@ -199,10 +232,12 @@

    cogl_handle_unref ()

    -
    void                cogl_handle_unref                   (CoglHandle Handle);
    +
    void                cogl_handle_unref                   (CoglHandle Handle);

    Drecreases the reference count of handle by 1; if the reference count reaches 0, the resources allocated by handle will be freed

    +

    +

    @@ -215,11 +250,13 @@

    CoglFuncPtr ()

    -
    void                (*CoglFuncPtr)                      (void);
    +
    void                (*CoglFuncPtr)                      (void);

    The type used by cogl for function pointers, note that this type is used as a generic catch-all cast for function pointers and the actual arguments and return type may be different.

    +

    +


    @@ -254,117 +291,119 @@ Pixel formats used by COGL. For the formats with a byte per component, the order of the components specify the order in increasing memory addresses. So for example -COGL_PIXEL_FORMAT_RGB_888 would have the red component in the +COGL_PIXEL_FORMAT_RGB_888 would have the red component in the lowest address, green in the next address and blue after that regardless of the endinanness of the system.

    For the 16-bit formats the component order specifies the order within a 16-bit number from most significant bit to least -significant. So for COGL_PIXEL_FORMAT_RGB_565, the red component +significant. So for COGL_PIXEL_FORMAT_RGB_565, the red component would be in bits 11-15, the green component would be in 6-11 and the blue component would be in 1-5. Therefore the order in memory depends on the endianness of the system.

    -When uploading a texture COGL_PIXEL_FORMAT_ANY can be used as the +When uploading a texture COGL_PIXEL_FORMAT_ANY can be used as the internal format. Cogl will try to pick the best format to use internally and convert the texture data if necessary.

    +

    +

    - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + @@ -383,16 +422,18 @@

    Target flags for FBOs.

    +

    +

    COGL_PIXEL_FORMAT_ANY

    COGL_PIXEL_FORMAT_ANY

    Any format

    COGL_PIXEL_FORMAT_A_8

    COGL_PIXEL_FORMAT_A_8

    8 bits alpha mask

    COGL_PIXEL_FORMAT_RGB_565

    COGL_PIXEL_FORMAT_RGB_565

    RGB, 16 bits

    COGL_PIXEL_FORMAT_RGBA_4444

    COGL_PIXEL_FORMAT_RGBA_4444

    RGBA, 16 bits

    COGL_PIXEL_FORMAT_RGBA_5551

    COGL_PIXEL_FORMAT_RGBA_5551

    RGBA, 16 bits

    COGL_PIXEL_FORMAT_YUV

    COGL_PIXEL_FORMAT_YUV

    Not currently supported

    COGL_PIXEL_FORMAT_G_8

    COGL_PIXEL_FORMAT_G_8

    Single luminance component

    COGL_PIXEL_FORMAT_RGB_888

    COGL_PIXEL_FORMAT_RGB_888

    RGB, 24 bits

    COGL_PIXEL_FORMAT_BGR_888

    COGL_PIXEL_FORMAT_BGR_888

    BGR, 24 bits

    COGL_PIXEL_FORMAT_RGBA_8888

    COGL_PIXEL_FORMAT_RGBA_8888

    RGBA, 32 bits

    COGL_PIXEL_FORMAT_BGRA_8888

    COGL_PIXEL_FORMAT_BGRA_8888

    BGRA, 32 bits

    COGL_PIXEL_FORMAT_ARGB_8888

    COGL_PIXEL_FORMAT_ARGB_8888

    ARGB, 32 bits

    COGL_PIXEL_FORMAT_ABGR_8888

    COGL_PIXEL_FORMAT_ABGR_8888

    ABGR, 32 bits

    COGL_PIXEL_FORMAT_RGBA_8888_PRE

    COGL_PIXEL_FORMAT_RGBA_8888_PRE

    Premultiplied RGBA, 32 bits

    COGL_PIXEL_FORMAT_BGRA_8888_PRE

    COGL_PIXEL_FORMAT_BGRA_8888_PRE

    Premultiplied BGRA, 32 bits

    COGL_PIXEL_FORMAT_ARGB_8888_PRE

    COGL_PIXEL_FORMAT_ARGB_8888_PRE

    Premultiplied ARGB, 32 bits

    COGL_PIXEL_FORMAT_ABGR_8888_PRE

    COGL_PIXEL_FORMAT_ABGR_8888_PRE

    Premultiplied ABGR, 32 bits

    COGL_PIXEL_FORMAT_RGBA_4444_PRE

    COGL_PIXEL_FORMAT_RGBA_4444_PRE

    Premultiplied RGBA, 16 bits

    COGL_PIXEL_FORMAT_RGBA_5551_PRE

    COGL_PIXEL_FORMAT_RGBA_5551_PRE

    Premultiplied RGBA, 16 bits
    - + - + @@ -411,21 +452,23 @@

    Types of auxiliary buffers

    +

    +

    COGL_WINDOW_BUFFER

    COGL_WINDOW_BUFFER

    FIXME

    COGL_OFFSCREEN_BUFFER

    COGL_OFFSCREEN_BUFFER

    FIXME
    - + - + - + @@ -446,33 +489,35 @@

    Data types for the components of cogl_vertex_buffer_add()

    +

    +

    COGL_BUFFER_BIT_COLOR

    COGL_BUFFER_BIT_COLOR

    Selects the primary color buffer

    COGL_BUFFER_BIT_DEPTH

    COGL_BUFFER_BIT_DEPTH

    Selects the depth buffer

    COGL_BUFFER_BIT_STENCIL

    COGL_BUFFER_BIT_STENCIL

    Selects the stencil buffer
    - + - + - + - + - + @@ -502,73 +547,75 @@

    Flags for the supported features.

    +

    +

    COGL_ATTRIBUTE_TYPE_BYTE

    COGL_ATTRIBUTE_TYPE_BYTE

    Data is the same size of a byte

    COGL_ATTRIBUTE_TYPE_UNSIGNED_BYTE

    COGL_ATTRIBUTE_TYPE_UNSIGNED_BYTE

    Data is the same size of an unsigned byte

    COGL_ATTRIBUTE_TYPE_SHORT

    COGL_ATTRIBUTE_TYPE_SHORT

    Data is the same size of a short integer

    COGL_ATTRIBUTE_TYPE_UNSIGNED_SHORT

    COGL_ATTRIBUTE_TYPE_UNSIGNED_SHORT

    Data is the same size of an unsigned short integer

    COGL_ATTRIBUTE_TYPE_FLOAT

    COGL_ATTRIBUTE_TYPE_FLOAT

    Data is the same size of a float
    - + - + - + - + - + - + - + - + - + - + - + - + - + @@ -579,9 +626,11 @@

    cogl_get_features ()

    -
    CoglFeatureFlags    cogl_get_features                   (void);
    +
    CoglFeatureFlags    cogl_get_features                   (void);

    Returns all of the features supported by COGL.

    +

    +

    COGL_FEATURE_TEXTURE_RECTANGLE

    COGL_FEATURE_TEXTURE_RECTANGLE

    ARB_texture_rectangle support

    COGL_FEATURE_TEXTURE_NPOT

    COGL_FEATURE_TEXTURE_NPOT

    ARB_texture_non_power_of_two support

    COGL_FEATURE_TEXTURE_YUV

    COGL_FEATURE_TEXTURE_YUV

    ycbcr conversion support

    COGL_FEATURE_TEXTURE_READ_PIXELS

    COGL_FEATURE_TEXTURE_READ_PIXELS

    glReadPixels() support

    COGL_FEATURE_SHADERS_GLSL

    COGL_FEATURE_SHADERS_GLSL

    GLSL support

    COGL_FEATURE_OFFSCREEN

    COGL_FEATURE_OFFSCREEN

    FBO support

    COGL_FEATURE_OFFSCREEN_MULTISAMPLE

    COGL_FEATURE_OFFSCREEN_MULTISAMPLE

    Multisample support on FBOs

    COGL_FEATURE_OFFSCREEN_BLIT

    COGL_FEATURE_OFFSCREEN_BLIT

    Blit support on FBOs

    COGL_FEATURE_FOUR_CLIP_PLANES

    COGL_FEATURE_FOUR_CLIP_PLANES

    At least 4 clip planes available

    COGL_FEATURE_STENCIL_BUFFER

    COGL_FEATURE_STENCIL_BUFFER

    Stencil buffer support

    COGL_FEATURE_VBOS

    COGL_FEATURE_VBOS

    VBO support

    COGL_FEATURE_PBOS

    COGL_FEATURE_PBOS

    PBO support

    COGL_FEATURE_UNSIGNED_INT_INDICES

    COGL_FEATURE_UNSIGNED_INT_INDICES

    Set if - COGL_INDICES_TYPE_UNSIGNED_INT is supported in + COGL_INDICES_TYPE_UNSIGNED_INT is supported in cogl_vertex_buffer_indices_new().
    @@ -596,12 +645,16 @@

    cogl_features_available ()

    -
    gboolean            cogl_features_available             (CoglFeatureFlags features);
    +
    gboolean            cogl_features_available             (CoglFeatureFlags features);

    Checks whether the given COGL features are available. Multiple features can be checked for by or-ing them together with the '|' -operator. TRUE is only returned if all of the requested features +operator. TRUE is only returned if all of the requested features are available.

    +

    +

    @@ -612,7 +665,7 @@ - @@ -621,8 +674,10 @@

    cogl_check_extension ()

    -
    gboolean            cogl_check_extension                (const char *name,
    -                                                         const char *ext);
    +
    gboolean            cogl_check_extension                (const char *name,
    +                                                         const char *ext);

    Warning

    cogl_check_extension has been deprecated since version 1.2 and should not be used in newly-written code. OpenGL is an implementation detail for Cogl and so it's @@ -635,6 +690,8 @@

    Check whether name occurs in list of extensions in ext.

    +

    +

    Returns :

    TRUE if the features are available, FALSE otherwise. + TRUE if the features are available, FALSE otherwise.
    @@ -650,7 +707,7 @@ - @@ -660,11 +717,13 @@

    cogl_get_proc_address ()

    -
    CoglFuncPtr         cogl_get_proc_address               (const char *name);
    +
    CoglFuncPtr         cogl_get_proc_address               (const char *name);

    Gets a pointer to a given GL or GL ES extension function. This acts as a wrapper around glXGetProcAddress() or whatever is the appropriate function for the current backend.

    +

    +

    Returns :

    TRUE if the extension occurs in the list, FALSE otherwise. + TRUE if the extension occurs in the list, FALSE otherwise.
    @@ -675,7 +734,7 @@ - @@ -685,16 +744,24 @@

    cogl_get_option_group ()

    -
    GOptionGroup *      cogl_get_option_group               (void);
    -

    -Retrieves the GOptionGroup used by COGL to parse the command +

    GOptionGroup *      cogl_get_option_group               (void);
    +

    +Retrieves the GOptionGroup used by COGL to parse the command line options. Clutter uses this to handle the COGL command line options during its initialization process.

    +

    +

    Returns :

    a pointer to the requested function or NULL if the + a pointer to the requested function or NULL if the function is not available.
    - @@ -704,27 +771,33 @@

    cogl_push_matrix ()

    -
    void                cogl_push_matrix                    (void);
    +
    void                cogl_push_matrix                    (void);

    Stores the current model-view matrix on the matrix stack. The matrix can later be restored with cogl_pop_matrix().

    +

    +


    cogl_pop_matrix ()

    -
    void                cogl_pop_matrix                     (void);
    +
    void                cogl_pop_matrix                     (void);

    Restores the current model-view matrix from the matrix stack.

    +

    +


    cogl_scale ()

    -
    void                cogl_scale                          (float x,
    -                                                         float y,
    -                                                         float z);
    +
    void                cogl_scale                          (float x,
    +                                                         float y,
    +                                                         float z);

    Multiplies the current model-view matrix by one that scales the x, y and z axes by the given values.

    +

    +

    Returns :

    a GOptionGroup + a GOptionGroup
    @@ -749,12 +822,14 @@

    cogl_translate ()

    -
    void                cogl_translate                      (float x,
    -                                                         float y,
    -                                                         float z);
    +
    void                cogl_translate                      (float x,
    +                                                         float y,
    +                                                         float z);

    Multiplies the current model-view matrix by one that translates the model along all three axes according to the given values.

    +

    +

    @@ -779,16 +854,18 @@

    cogl_rotate ()

    -
    void                cogl_rotate                         (float angle,
    -                                                         float x,
    -                                                         float y,
    -                                                         float z);
    +
    void                cogl_rotate                         (float angle,
    +                                                         float x,
    +                                                         float y,
    +                                                         float z);

    Multiplies the current model-view matrix by one that rotates the model around the vertex specified by x, y and z. The rotation follows the right-hand thumb rule so for example rotating by 10 degrees about the vertex (0, 0, 1) causes a small counter-clockwise rotation.

    +

    +

    @@ -818,15 +895,17 @@

    cogl_frustum ()

    -
    void                cogl_frustum                        (float left,
    -                                                         float right,
    -                                                         float bottom,
    -                                                         float top,
    -                                                         float z_near,
    -                                                         float z_far);
    +
    void                cogl_frustum                        (float left,
    +                                                         float right,
    +                                                         float bottom,
    +                                                         float top,
    +                                                         float z_near,
    +                                                         float z_far);

    Replaces the current projection matrix with a perspective matrix for the given viewing frustum.

    +

    +

    @@ -867,13 +946,15 @@

    cogl_perspective ()

    -
    void                cogl_perspective                    (float fovy,
    -                                                         float aspect,
    -                                                         float z_near,
    -                                                         float z_far);
    +
    void                cogl_perspective                    (float fovy,
    +                                                         float aspect,
    +                                                         float z_near,
    +                                                         float z_far);

    Replaces the current projection matrix with a perspective matrix based on the provided values.

    +

    +

    @@ -903,15 +984,17 @@

    cogl_ortho ()

    -
    void                cogl_ortho                          (float left,
    -                                                         float right,
    -                                                         float bottom,
    -                                                         float top,
    -                                                         float near,
    -                                                         float far);
    +
    void                cogl_ortho                          (float left,
    +                                                         float right,
    +                                                         float bottom,
    +                                                         float top,
    +                                                         float near,
    +                                                         float far);

    Replaces the current projection matrix with a parallel projection matrix.

    +

    +

    @@ -954,9 +1037,11 @@

    cogl_get_modelview_matrix ()

    -
    void                cogl_get_modelview_matrix           (CoglMatrix *matrix);
    +
    void                cogl_get_modelview_matrix           (CoglMatrix *matrix);

    Stores the current model-view matrix in matrix.

    +

    +

    @@ -968,9 +1053,11 @@

    cogl_set_modelview_matrix ()

    -
    void                cogl_set_modelview_matrix           (CoglMatrix *matrix);
    +
    void                cogl_set_modelview_matrix           (CoglMatrix *matrix);

    Loads matrix as the new model-view matrix.

    +

    +

    @@ -983,9 +1070,11 @@

    cogl_get_projection_matrix ()

    -
    void                cogl_get_projection_matrix          (CoglMatrix *matrix);
    +
    void                cogl_get_projection_matrix          (CoglMatrix *matrix);

    Stores the current projection matrix in matrix.

    +

    +

    @@ -997,9 +1086,11 @@

    cogl_set_projection_matrix ()

    -
    void                cogl_set_projection_matrix          (CoglMatrix *matrix);
    +
    void                cogl_set_projection_matrix          (CoglMatrix *matrix);

    Loads matrix as the new projection matrix.

    +

    +

    @@ -1012,14 +1103,16 @@

    cogl_viewport ()

    -
    void                cogl_viewport                       (unsigned int width,
    -                                                         unsigned int height);
    +
    void                cogl_viewport                       (unsigned int width,
    +                                                         unsigned int height);

    Warning

    cogl_viewport has been deprecated since version 1.2 and should not be used in newly-written code. Use cogl_set_viewport() instead

    Replace the current viewport with the given values.

    +

    +

    @@ -1040,12 +1133,14 @@

    cogl_set_viewport ()

    -
    void                cogl_set_viewport                   (int x,
    -                                                         int y,
    -                                                         int width,
    -                                                         int height);
    +
    void                cogl_set_viewport                   (int x,
    +                                                         int y,
    +                                                         int width,
    +                                                         int height);

    Replaces the current viewport with the given values.

    +

    +

    @@ -1076,11 +1171,13 @@

    cogl_get_viewport ()

    -
    void                cogl_get_viewport                   (float v[4]);
    +
    void                cogl_get_viewport                   (float v[4]);

    Stores the current viewport in v. v[0] and v[1] get the x and y position of the viewport and v[2] and v[3] get the width and height.

    +

    +

    @@ -1092,11 +1189,13 @@

    cogl_clear ()

    -
    void                cogl_clear                          (const CoglColor *color,
    -                                                         unsigned long  buffers);
    +
    void                cogl_clear                          (const CoglColor *color,
    +                                                         unsigned long  buffers);

    Clears all the auxiliary buffers identified in the buffers mask, and if that includes the color buffer then the specified color is used.

    +

    +

    @@ -1117,32 +1216,34 @@

    cogl_get_bitmasks ()

    -
    void                cogl_get_bitmasks                   (int *red,
    -                                                         int *green,
    -                                                         int *blue,
    -                                                         int *alpha);
    +
    void                cogl_get_bitmasks                   (int *red,
    +                                                         int *green,
    +                                                         int *blue,
    +                                                         int *alpha);

    Gets the number of bitplanes used for each of the color components -in the color buffer. Pass NULL for any of the arguments if the +in the color buffer. Pass NULL for any of the arguments if the value is not required.

    +

    +

    - + - + - + - +

    red :

    Return location for the number of red bits or NULL. out. Return location for the number of red bits or NULL. out.

    green :

    Return location for the number of green bits or NULL. out. Return location for the number of green bits or NULL. out.

    blue :

    Return location for the number of blue bits or NULL. out. Return location for the number of blue bits or NULL. out.

    alpha :

    Return location for the number of alpha bits or NULL. out. Return location for the number of alpha bits or NULL. out.
    @@ -1150,18 +1251,26 @@

    cogl_set_depth_test_enabled ()

    -
    void                cogl_set_depth_test_enabled         (gboolean setting);
    +
    void                cogl_set_depth_test_enabled         (gboolean setting);

    Sets whether depth testing is enabled. If it is disabled then the order that actors are layered on the screen depends solely on the -order specified using clutter_actor_raise() and -clutter_actor_lower(), otherwise it will also take into account the +order specified using clutter_actor_raise() and +clutter_actor_lower(), otherwise it will also take into account the actor's depth. Depth testing is disabled by default.

    +

    +

    -

    setting :

    TRUE to enable depth testing or FALSE to disable. + TRUE to enable depth testing or FALSE to disable.
    @@ -1169,14 +1278,18 @@

    cogl_get_depth_test_enabled ()

    -
    gboolean            cogl_get_depth_test_enabled         (void);
    +
    gboolean            cogl_get_depth_test_enabled         (void);

    Queries if depth testing has been enabled via cogl_set_depth_test_enable()

    +

    +

    -

    Returns :

    TRUE if depth testing is enabled, and FALSE otherwise + TRUE if depth testing is enabled, and FALSE otherwise
    @@ -1184,18 +1297,22 @@

    cogl_set_backface_culling_enabled ()

    -
    void                cogl_set_backface_culling_enabled   (gboolean setting);
    +
    void                cogl_set_backface_culling_enabled   (gboolean setting);

    Sets whether textures positioned so that their backface is showing should be hidden. This can be used to efficiently draw two-sided textures or fully closed cubes without enabling depth testing. This only affects calls to the cogl_rectangle* family of functions and cogl_vertex_buffer_draw*. Backface culling is disabled by default.

    +

    +

    -

    setting :

    TRUE to enable backface culling or FALSE to disable. + TRUE to enable backface culling or FALSE to disable.
    @@ -1203,15 +1320,19 @@

    cogl_get_backface_culling_enabled ()

    -
    gboolean            cogl_get_backface_culling_enabled   (void);
    +
    gboolean            cogl_get_backface_culling_enabled   (void);

    Queries if backface culling has been enabled via cogl_set_backface_culling_enabled()

    +

    +

    -

    Returns :

    TRUE if backface culling is enabled, and FALSE otherwise + TRUE if backface culling is enabled, and FALSE otherwise
    @@ -1227,7 +1348,7 @@

    The fog mode determines the equation used to calculate the fogging blend -factor while fogging is enabled. The simplest COGL_FOG_MODE_LINEAR mode +factor while fogging is enabled. The simplest COGL_FOG_MODE_LINEAR mode determines f as:

    @@ -1240,11 +1361,13 @@

    Where eye_distance is the distance of the current fragment in eye coordinates from the origin.

    +

    +

    - + - + - +

    COGL_FOG_MODE_LINEAR

    COGL_FOG_MODE_LINEAR

    Calculates the fog blend factor as:
       f = end - eye_distance / end - start
    @@ -1252,7 +1375,7 @@
     

    COGL_FOG_MODE_EXPONENTIAL

    COGL_FOG_MODE_EXPONENTIAL

    Calculates the fog blend factor as:
       f = e ^ -(density * eye_distance)
    @@ -1260,7 +1383,7 @@
     

    COGL_FOG_MODE_EXPONENTIAL_SQUARED

    COGL_FOG_MODE_EXPONENTIAL_SQUARED

    Calculates the fog blend factor as:
       f = e ^ -(density * eye_distance)^2
    @@ -1274,11 +1397,11 @@
     

    cogl_set_fog ()

    -
    void                cogl_set_fog                        (const CoglColor *fog_color,
    -                                                         CoglFogMode mode,
    -                                                         float density,
    -                                                         float z_near,
    -                                                         float z_far);
    +
    void                cogl_set_fog                        (const CoglColor *fog_color,
    +                                                         CoglFogMode mode,
    +                                                         float density,
    +                                                         float z_near,
    +                                                         float z_far);

    Enables fogging. Fogging causes vertices that are further away from the eye to be rendered with a different color. The color is determined according to @@ -1297,6 +1420,8 @@ and use cogl_material_set_color() you can only use fogging with fully opaque primitives. This might improve in the future when we can depend on fragment shaders.

    +

    +

    @@ -1313,8 +1438,8 @@ - @@ -1333,15 +1458,17 @@

    cogl_disable_fog ()

    -
    void                cogl_disable_fog                    (void);
    +
    void                cogl_disable_fog                    (void);

    This function disables fogging, so primitives drawn afterwards will not be blended with any previously set fog color.

    +

    +


    cogl_set_source ()

    -
    void                cogl_set_source                     (CoglHandle material);
    +
    void                cogl_set_source                     (CoglHandle material);

    This function sets the source material that will be used to fill subsequent geometry emitted via the cogl API. @@ -1352,6 +1479,8 @@

    Note

    In the future we may add the ability to set a front facing material, and a back facing material, in which case this function will set both to the same.
    +

    +

    density :

    Used by COGL_FOG_MODE_EXPONENTIAL and by - COGL_FOG_MODE_EXPONENTIAL_SQUARED equations. + Used by COGL_FOG_MODE_EXPONENTIAL and by + COGL_FOG_MODE_EXPONENTIAL_SQUARED equations.
    @@ -1365,7 +1494,7 @@

    cogl_set_source_color ()

    -
    void                cogl_set_source_color               (const CoglColor *color);
    +
    void                cogl_set_source_color               (const CoglColor *color);

    This is a convenience function for creating a solid fill source material from the given color. This color will be used for any subsequent drawing @@ -1379,6 +1508,8 @@

    See also cogl_set_source_color4ub() and cogl_set_source_color4f() if you already have the color components.

    +

    +

    @@ -1392,10 +1523,18 @@

    cogl_set_source_color4ub ()

    -
    void                cogl_set_source_color4ub            (guint8 red,
    -                                                         guint8 green,
    -                                                         guint8 blue,
    -                                                         guint8 alpha);
    +
    void                cogl_set_source_color4ub            (guint8 red,
    +                                                         guint8 green,
    +                                                         guint8 blue,
    +                                                         guint8 alpha);

    This is a convenience function for creating a solid fill source material from the given color using unsigned bytes for each component. This @@ -1404,6 +1543,8 @@

    The value for each component is an unsigned byte in the range between 0 and 255.

    +

    +

    @@ -1434,10 +1575,10 @@

    cogl_set_source_color4f ()

    -
    void                cogl_set_source_color4f             (float red,
    -                                                         float green,
    -                                                         float blue,
    -                                                         float alpha);
    +
    void                cogl_set_source_color4f             (float red,
    +                                                         float green,
    +                                                         float blue,
    +                                                         float alpha);

    This is a convenience function for creating a solid fill source material from the given color using normalized values for each component. This color @@ -1447,6 +1588,8 @@ The value for each component is a fixed point number in the range between 0 and 1.0. If the values passed in are outside that range, they will be clamped.

    +

    +

    @@ -1477,7 +1620,7 @@

    cogl_set_source_texture ()

    -
    void                cogl_set_source_texture             (CoglHandle texture_handle);
    +
    void                cogl_set_source_texture             (CoglHandle texture_handle);

    This is a convenience function for creating a material with the first layer set to texture_handle and setting that material as the source with @@ -1494,6 +1637,8 @@ cogl_material_set_layer (material, 0, tex_handle); cogl_set_source (material); +

    +

    @@ -1513,10 +1658,12 @@

    Flags for cogl_read_pixels()

    +

    +

    - + @@ -1526,13 +1673,15 @@

    cogl_read_pixels ()

    -
    void                cogl_read_pixels                    (int x,
    -                                                         int y,
    -                                                         int width,
    -                                                         int height,
    -                                                         CoglReadPixelsFlags source,
    -                                                         CoglPixelFormat format,
    -                                                         guint8 *pixels);
    +
    void                cogl_read_pixels                    (int x,
    +                                                         int y,
    +                                                         int width,
    +                                                         int height,
    +                                                         CoglReadPixelsFlags source,
    +                                                         CoglPixelFormat format,
    +                                                         guint8 *pixels);

    This reads a rectangle of pixels from the current framebuffer where position (0, 0) is the top left. The pixel at (x, y) is the first @@ -1544,6 +1693,8 @@ read the pixel values without any conversion you should either specify a format that doesn't use an alpha channel or use one of the formats ending in PRE.

    +

    +

    COGL_READ_PIXELS_COLOR_BUFFER

    COGL_READ_PIXELS_COLOR_BUFFER

    Read from the color buffer
    @@ -1590,7 +1741,7 @@

    cogl_flush ()

    -
    void                cogl_flush                          (void);
    +
    void                cogl_flush                          (void);

    This function should only need to be called in exceptional circumstances.

    @@ -1616,12 +1767,14 @@ conflicting with Cogl internals. For example clutter-gst which currently uses direct GL calls to bind ARBfp programs will very likely break when Cogl starts to use ARBfb programs itself for the material API.

    +

    +

    Since 1.0


    cogl_begin_gl ()

    -
    void                cogl_begin_gl                       (void);
    +
    void                cogl_begin_gl                       (void);

    We do not advise nor reliably support the interleaving of raw GL drawing and Cogl drawing functions, but if you insist, cogl_begin_gl() and cogl_end_gl() @@ -1718,21 +1871,25 @@ Again we would like to stress, we do not advise the use of this API and if possible we would prefer to improve Cogl than have developers require raw OpenGL.

    +

    +

    Since 1.0


    cogl_end_gl ()

    -
    void                cogl_end_gl                         (void);
    +
    void                cogl_end_gl                         (void);

    This is the counterpart to cogl_begin_gl() used to delimit blocks of drawing code using raw OpenGL. Please refer to cogl_begin_gl() for full details.

    +

    +

    Since 1.0

    + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/cogl/html/cogl.devhelp +++ clutter-1.0-1.2.4/doc/reference/cogl/html/cogl.devhelp @@ -29,7 +29,7 @@ - + @@ -140,7 +140,7 @@ - + @@ -257,50 +257,65 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + --- clutter-1.0-1.2.4.orig/doc/reference/cogl/html/ix05.html +++ clutter-1.0-1.2.4/doc/reference/cogl/html/ix05.html @@ -8,7 +8,7 @@ - + @@ -20,34 +20,20 @@ -
    - + - - - +

    -Index of new symbols in 1.2

    -

    B

    +Index of new symbols in 1.2
    +
    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/cogl/html/index.sgml +++ clutter-1.0-1.2.4/doc/reference/cogl/html/index.sgml @@ -2,58 +2,16 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -81,9 +39,6 @@ - - - @@ -92,7 +47,6 @@ - @@ -127,10 +81,6 @@ - - - - @@ -176,21 +126,9 @@ - - - - - - - - - + - - - - @@ -202,15 +140,8 @@ - - - - - - - @@ -272,19 +203,9 @@ - - - - - - - - - - @@ -310,8 +231,6 @@ - - @@ -353,50 +272,65 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -405,19 +339,12 @@ - - - - - - - --- clutter-1.0-1.2.4.orig/doc/reference/cogl/html/ix01.html +++ clutter-1.0-1.2.4/doc/reference/cogl/html/ix01.html @@ -8,7 +8,7 @@ - + @@ -20,57 +20,43 @@ - - + - - - +

    -Index of all symbols

    -

    A

    +Index of all symbols
    +
    + +
    +

    B

    +
    cogl_begin_gl
    cogl_bitmap_get_size_from_file
    @@ -79,7 +65,7 @@
    CoglBlendStringError
    -
    COGL_BLEND_STRING_ERROR
    +
    COGL_BLEND_STRING_ERROR
    CoglBufferAccess
    @@ -107,7 +93,11 @@
    cogl_buffer_unmap
    -

    C

    +
    +
    +
    +

    C

    +
    cogl_check_extension
    cogl_clear
    @@ -176,102 +166,122 @@
    cogl_create_shader
    -

    D

    +
    +
    +
    +

    D

    +
    cogl_disable_fog
    -

    E

    +
    +
    +
    +

    E

    +
    cogl_end_gl
    -

    F

    +
    +
    +
    +

    F

    +
    CoglFeatureFlags
    cogl_features_available
    CoglFixed
    -
    COGL_FIXED_0_5
    +
    COGL_FIXED_0_5
    -
    COGL_FIXED_1
    +
    COGL_FIXED_1
    -
    COGL_FIXED_120
    +
    COGL_FIXED_120
    -
    COGL_FIXED_180
    +
    COGL_FIXED_180
    -
    COGL_FIXED_240
    +
    COGL_FIXED_240
    -
    COGL_FIXED_255
    +
    COGL_FIXED_255
    -
    COGL_FIXED_270
    +
    COGL_FIXED_270
    -
    COGL_FIXED_2_PI
    +
    COGL_FIXED_2_PI
    -
    COGL_FIXED_30
    +
    COGL_FIXED_30
    -
    COGL_FIXED_360
    +
    COGL_FIXED_360
    -
    COGL_FIXED_45
    +
    COGL_FIXED_45
    -
    COGL_FIXED_60
    +
    COGL_FIXED_60
    -
    COGL_FIXED_90
    +
    COGL_FIXED_90
    cogl_fixed_atan2
    cogl_fixed_atani
    -
    COGL_FIXED_BITS
    +
    COGL_FIXED_BITS
    -
    COGL_FIXED_CEIL
    +
    COGL_FIXED_CEIL
    cogl_fixed_cos
    -
    COGL_FIXED_DIV
    +
    COGL_FIXED_DIV
    -
    COGL_FIXED_EPSILON
    +
    COGL_FIXED_EPSILON
    -
    COGL_FIXED_FAST_DIV
    +
    COGL_FIXED_FAST_DIV
    -
    COGL_FIXED_FAST_MUL
    +
    COGL_FIXED_FAST_MUL
    -
    COGL_FIXED_FLOOR
    +
    COGL_FIXED_FLOOR
    -
    COGL_FIXED_FRACTION
    +
    COGL_FIXED_FRACTION
    -
    COGL_FIXED_FROM_DOUBLE
    +
    COGL_FIXED_FROM_DOUBLE
    -
    COGL_FIXED_FROM_FLOAT
    +
    COGL_FIXED_FROM_FLOAT
    -
    COGL_FIXED_FROM_INT
    +
    COGL_FIXED_FROM_INT
    -
    COGL_FIXED_MAX
    +
    cogl_fixed_log2
    -
    COGL_FIXED_MIN
    +
    COGL_FIXED_MAX
    -
    COGL_FIXED_MUL
    +
    COGL_FIXED_MIN
    -
    COGL_FIXED_MUL_DIV
    +
    COGL_FIXED_MUL
    -
    COGL_FIXED_PI
    +
    COGL_FIXED_MUL_DIV
    -
    COGL_FIXED_PI_2
    +
    COGL_FIXED_PI
    -
    COGL_FIXED_PI_4
    +
    COGL_FIXED_PI_2
    -
    COGL_FIXED_Q
    +
    COGL_FIXED_PI_4
    +
    +
    cogl_fixed_pow
    +
    +
    cogl_fixed_pow2
    +
    +
    COGL_FIXED_Q
    cogl_fixed_sin
    +
    cogl_fixed_sqrt
    +
    cogl_fixed_tan
    -
    COGL_FIXED_TO_DOUBLE
    +
    COGL_FIXED_TO_DOUBLE
    -
    COGL_FIXED_TO_FLOAT
    +
    COGL_FIXED_TO_FLOAT
    -
    COGL_FIXED_TO_INT
    +
    COGL_FIXED_TO_INT
    -
    COGL_FLOAT_TO_INT
    +
    COGL_FLOAT_TO_INT
    -
    COGL_FLOAT_TO_UINT
    +
    COGL_FLOAT_TO_UINT
    cogl_flush
    @@ -281,7 +291,11 @@
    CoglFuncPtr
    -

    G

    +
    +
    + + +
    +

    I

    +
    CoglIndicesType
    -
    COGL_INVALID_HANDLE
    +
    COGL_INVALID_HANDLE
    cogl_is_bitmap
    @@ -330,7 +352,11 @@
    cogl_is_vertex_buffer
    -

    M

    +
    +
    + + + +
    +

    R

    +
    +
    COGL_RADIANS_TO_DEGREES
    CoglReadPixelsFlags
    @@ -542,7 +580,11 @@
    cogl_rotate
    -

    S

    +
    +
    + +
    +

    T

    +
    CoglTextureFlags
    CoglTextureVertex
    @@ -630,7 +684,11 @@
    cogl_translate
    -

    V

    +
    +
    + +
    +
    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/cogl/tmpl/cogl-color.sgml +++ clutter-1.0-1.2.4/doc/reference/cogl/tmpl/cogl-color.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/cogl/tmpl/cogl-texture.sgml +++ clutter-1.0-1.2.4/doc/reference/cogl/tmpl/cogl-texture.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/cogl/tmpl/cogl-matrix.sgml +++ clutter-1.0-1.2.4/doc/reference/cogl/tmpl/cogl-matrix.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/cogl/tmpl/cogl-offscreen.sgml +++ clutter-1.0-1.2.4/doc/reference/cogl/tmpl/cogl-offscreen.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/cogl/tmpl/cogl-primitives.sgml +++ clutter-1.0-1.2.4/doc/reference/cogl/tmpl/cogl-primitives.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/cogl/tmpl/cogl-fixed.sgml +++ clutter-1.0-1.2.4/doc/reference/cogl/tmpl/cogl-fixed.sgml @@ -9,13 +9,11 @@ - - @@ -313,6 +311,36 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + +@x: +@Returns: + + @@ -341,6 +369,34 @@ @Returns: + + + + + +@x: +@Returns: + + + + + + + +@x: +@y: +@Returns: + + + + + + + +@x: +@Returns: + + @@ -350,6 +406,15 @@ @Returns: + + + + + +@x: +@Returns: + + @@ -365,3 +430,62 @@ + + + + + +@x: + + + + + + + +@x: + + + + + + + +@x: + + + + + + + +@x: + + + + + + + +@angle: +@Returns: + + + + + + + +@angle: +@Returns: + + + + + + + +@angle: +@Returns: + + --- clutter-1.0-1.2.4.orig/doc/reference/cogl/tmpl/cogl-clipping.sgml +++ clutter-1.0-1.2.4/doc/reference/cogl/tmpl/cogl-clipping.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/cogl/tmpl/cogl.sgml +++ clutter-1.0-1.2.4/doc/reference/cogl/tmpl/cogl.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/cogl/tmpl/cogl-buffer.sgml +++ clutter-1.0-1.2.4/doc/reference/cogl/tmpl/cogl-buffer.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/cogl/tmpl/cogl-material.sgml +++ clutter-1.0-1.2.4/doc/reference/cogl/tmpl/cogl-material.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/cogl/tmpl/cogl-bitmap.sgml +++ clutter-1.0-1.2.4/doc/reference/cogl/tmpl/cogl-bitmap.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/cogl/tmpl/cogl-vertex-buffer.sgml +++ clutter-1.0-1.2.4/doc/reference/cogl/tmpl/cogl-vertex-buffer.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/cogl/tmpl/cogl-shaders.sgml +++ clutter-1.0-1.2.4/doc/reference/cogl/tmpl/cogl-shaders.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/clutter.devhelp +++ clutter-1.0-1.2.4/doc/reference/clutter/html/clutter.devhelp @@ -126,16 +126,16 @@ - - - - - - + + + + + + - + @@ -443,7 +443,7 @@ - + @@ -603,8 +603,8 @@ - - + + @@ -1062,7 +1062,7 @@ - + @@ -1080,8 +1080,8 @@ - - + + @@ -1122,7 +1122,7 @@ - + @@ -1184,13 +1184,13 @@ - + - + - + @@ -1248,7 +1248,7 @@ - + @@ -1259,22 +1259,22 @@ - + - - - - - - - - - - + + + + + + + + + + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/running-clutter.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/running-clutter.html @@ -8,7 +8,7 @@ - + @@ -267,6 +267,6 @@
    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/index.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/index.html @@ -6,7 +6,7 @@ - + @@ -58,7 +58,7 @@
    -

    +

    Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later @@ -345,6 +345,6 @@

    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ClutterBehaviourOpacity.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ClutterBehaviourOpacity.html @@ -8,7 +8,7 @@ - + @@ -62,14 +62,14 @@ Top -  |  - Description -  |  - Object Hierarchy -  |  - Implemented Interfaces -  |  - Properties +  |  + Description +  |  + Object Hierarchy +  |  + Implemented Interfaces +  |  + Properties
    @@ -83,25 +83,40 @@

    Synopsis

    -
                        ClutterBehaviourOpacity;
    +
    +                    ClutterBehaviourOpacity;
                         ClutterBehaviourOpacityClass;
    -ClutterBehaviour *  clutter_behaviour_opacity_new       (ClutterAlpha *alpha,
    -                                                         guint8 opacity_start,
    -                                                         guint8 opacity_end);
    -void                clutter_behaviour_opacity_set_bounds
    -                                                        (ClutterBehaviourOpacity *behaviour,
    -                                                         guint8 opacity_start,
    -                                                         guint8 opacity_end);
    -void                clutter_behaviour_opacity_get_bounds
    -                                                        (ClutterBehaviourOpacity *behaviour,
    -                                                         guint8 *opacity_start,
    -                                                         guint8 *opacity_end);
    +ClutterBehaviour *  clutter_behaviour_opacity_new       (ClutterAlpha *alpha,
    +                                                         guint8 opacity_start,
    +                                                         guint8 opacity_end);
    +void                clutter_behaviour_opacity_set_bounds
    +                                                        (ClutterBehaviourOpacity *behaviour,
    +                                                         guint8 opacity_start,
    +                                                         guint8 opacity_end);
    +void                clutter_behaviour_opacity_get_bounds
    +                                                        (ClutterBehaviourOpacity *behaviour,
    +                                                         guint8 *opacity_start,
    +                                                         guint8 *opacity_end);
     

    Object Hierarchy

    -  GObject
    +  GObject
        +----ClutterBehaviour
              +----ClutterBehaviourOpacity
     
    @@ -115,14 +130,20 @@

    Properties

    -  "opacity-end"              guint                 : Read / Write
    -  "opacity-start"            guint                 : Read / Write
    +  "opacity-end"              guint                 : Read / Write
    +  "opacity-start"            guint                 : Read / Write
     

    Description

    ClutterBehaviourOpacity controls the opacity of a set of actors.

    +

    +

    Details

    @@ -132,6 +153,8 @@

    The ClutterBehaviourOpacity structure contains only private data and should be accessed using the provided API

    +

    +

    Since 0.2


    @@ -142,24 +165,32 @@

    The ClutterBehaviourOpacityClas structure contains only private data

    +

    +

    Since 0.2


    clutter_behaviour_opacity_new ()

    -
    ClutterBehaviour *  clutter_behaviour_opacity_new       (ClutterAlpha *alpha,
    -                                                         guint8 opacity_start,
    -                                                         guint8 opacity_end);
    +
    ClutterBehaviour *  clutter_behaviour_opacity_new       (ClutterAlpha *alpha,
    +                                                         guint8 opacity_start,
    +                                                         guint8 opacity_end);

    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.

    +

    +

    - @@ -185,13 +216,19 @@

    clutter_behaviour_opacity_set_bounds ()

    -
    void                clutter_behaviour_opacity_set_bounds
    -                                                        (ClutterBehaviourOpacity *behaviour,
    -                                                         guint8 opacity_start,
    -                                                         guint8 opacity_end);
    +
    void                clutter_behaviour_opacity_set_bounds
    +                                                        (ClutterBehaviourOpacity *behaviour,
    +                                                         guint8 opacity_start,
    +                                                         guint8 opacity_end);

    Sets the initial and final levels of the opacity applied by behaviour on each actor it controls.

    +

    +

    alpha :

    a ClutterAlpha instance, or NULL + a ClutterAlpha instance, or NULL
    @@ -217,13 +254,19 @@

    clutter_behaviour_opacity_get_bounds ()

    -
    void                clutter_behaviour_opacity_get_bounds
    -                                                        (ClutterBehaviourOpacity *behaviour,
    -                                                         guint8 *opacity_start,
    -                                                         guint8 *opacity_end);
    +
    void                clutter_behaviour_opacity_get_bounds
    +                                                        (ClutterBehaviourOpacity *behaviour,
    +                                                         guint8 *opacity_start,
    +                                                         guint8 *opacity_end);

    Gets the initial and final levels of the opacity applied by behaviour on each actor it controls.

    +

    +

    @@ -234,12 +277,12 @@ - - @@ -251,27 +294,35 @@

    Property Details

    The "opacity-end" property

    -
      "opacity-end"              guint                 : Read / Write
    +
      "opacity-end"              guint                 : Read / Write

    Final opacity level of the behaviour.

    +

    +

    Allowed values: <= 255

    Default value: 0

    -

    Since 0.2

    +

    Since 0.2


    The "opacity-start" property

    -
      "opacity-start"            guint                 : Read / Write
    +
      "opacity-start"            guint                 : Read / Write

    Initial opacity level of the behaviour.

    +

    +

    Allowed values: <= 255

    Default value: 0

    -

    Since 0.2

    +

    Since 0.2

    + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ClutterBehaviourScale.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ClutterBehaviourScale.html @@ -8,7 +8,7 @@ - + @@ -62,14 +62,14 @@

    opacity_start :

    return location for the minimum level of opacity, or NULL + return location for the minimum level of opacity, or NULL

    opacity_end :

    return location for the maximum level of opacity, or NULL + return location for the maximum level of opacity, or NULL
    Top -  |  - Description -  |  - Object Hierarchy -  |  - Implemented Interfaces -  |  - Properties +  |  + Description +  |  + Object Hierarchy +  |  + Implemented Interfaces +  |  + Properties
    @@ -83,30 +83,57 @@

    Synopsis

    -
    enum                ClutterGravity;
    +
    +enum                ClutterGravity;
                         ClutterBehaviourScale;
                         ClutterBehaviourScaleClass;
    -ClutterBehaviour *  clutter_behaviour_scale_new         (ClutterAlpha *alpha,
    -                                                         gdouble x_scale_start,
    -                                                         gdouble y_scale_start,
    -                                                         gdouble x_scale_end,
    -                                                         gdouble y_scale_end);
    -void                clutter_behaviour_scale_set_bounds  (ClutterBehaviourScale *scale,
    -                                                         gdouble x_scale_start,
    -                                                         gdouble y_scale_start,
    -                                                         gdouble x_scale_end,
    -                                                         gdouble y_scale_end);
    -void                clutter_behaviour_scale_get_bounds  (ClutterBehaviourScale *scale,
    -                                                         gdouble *x_scale_start,
    -                                                         gdouble *y_scale_start,
    -                                                         gdouble *x_scale_end,
    -                                                         gdouble *y_scale_end);
    +ClutterBehaviour *  clutter_behaviour_scale_new         (ClutterAlpha *alpha,
    +                                                         gdouble x_scale_start,
    +                                                         gdouble y_scale_start,
    +                                                         gdouble x_scale_end,
    +                                                         gdouble y_scale_end);
    +void                clutter_behaviour_scale_set_bounds  (ClutterBehaviourScale *scale,
    +                                                         gdouble x_scale_start,
    +                                                         gdouble y_scale_start,
    +                                                         gdouble x_scale_end,
    +                                                         gdouble y_scale_end);
    +void                clutter_behaviour_scale_get_bounds  (ClutterBehaviourScale *scale,
    +                                                         gdouble *x_scale_start,
    +                                                         gdouble *y_scale_start,
    +                                                         gdouble *x_scale_end,
    +                                                         gdouble *y_scale_end);
     

    Object Hierarchy

    -  GObject
    +  GObject
        +----ClutterBehaviour
              +----ClutterBehaviourScale
     
    @@ -120,16 +147,26 @@

    Properties

    -  "x-scale-end"              gdouble               : Read / Write
    -  "x-scale-start"            gdouble               : Read / Write
    -  "y-scale-end"              gdouble               : Read / Write
    -  "y-scale-start"            gdouble               : Read / Write
    +  "x-scale-end"              gdouble               : Read / Write
    +  "x-scale-start"            gdouble               : Read / Write
    +  "y-scale-end"              gdouble               : Read / Write
    +  "y-scale-start"            gdouble               : Read / Write
     

    Description

    A ClutterBehaviourScale interpolates actors size between two values.

    +

    +

    Details

    @@ -150,58 +187,60 @@

    Gravity of the scaling operations. When a gravity different than -CLUTTER_GRAVITY_NONE is used, an actor is scaled keeping the position +CLUTTER_GRAVITY_NONE is used, an actor is scaled keeping the position of the specified portion at the same coordinates.

    +

    +

    - + - + - + - + - + - + - + - + - + - + @@ -216,6 +255,8 @@

    The ClutterBehaviourScale struct contains only private data and should be accessed using the provided API

    +

    +

    Since 0.2


    @@ -226,18 +267,30 @@

    The ClutterBehaviourScaleClass struct contains only private data

    +

    +

    Since 0.2


    clutter_behaviour_scale_new ()

    -
    ClutterBehaviour *  clutter_behaviour_scale_new         (ClutterAlpha *alpha,
    -                                                         gdouble x_scale_start,
    -                                                         gdouble y_scale_start,
    -                                                         gdouble x_scale_end,
    -                                                         gdouble y_scale_end);
    +
    ClutterBehaviour *  clutter_behaviour_scale_new         (ClutterAlpha *alpha,
    +                                                         gdouble x_scale_start,
    +                                                         gdouble y_scale_start,
    +                                                         gdouble x_scale_end,
    +                                                         gdouble y_scale_end);

    Creates a new ClutterBehaviourScale instance.

    +

    +

    CLUTTER_GRAVITY_NONE

    CLUTTER_GRAVITY_NONE

    Do not apply any gravity

    CLUTTER_GRAVITY_NORTH

    CLUTTER_GRAVITY_NORTH

    Scale from topmost downwards

    CLUTTER_GRAVITY_NORTH_EAST

    CLUTTER_GRAVITY_NORTH_EAST

    Scale from the top right corner

    CLUTTER_GRAVITY_EAST

    CLUTTER_GRAVITY_EAST

    Scale from the right side

    CLUTTER_GRAVITY_SOUTH_EAST

    CLUTTER_GRAVITY_SOUTH_EAST

    Scale from the bottom right corner

    CLUTTER_GRAVITY_SOUTH

    CLUTTER_GRAVITY_SOUTH

    Scale from the bottom upwards

    CLUTTER_GRAVITY_SOUTH_WEST

    CLUTTER_GRAVITY_SOUTH_WEST

    Scale from the bottom left corner

    CLUTTER_GRAVITY_WEST

    CLUTTER_GRAVITY_WEST

    Scale from the left side

    CLUTTER_GRAVITY_NORTH_WEST

    CLUTTER_GRAVITY_NORTH_WEST

    Scale from the top left corner

    CLUTTER_GRAVITY_CENTER

    CLUTTER_GRAVITY_CENTER

    Scale from the center.
    @@ -279,13 +332,23 @@

    clutter_behaviour_scale_set_bounds ()

    -
    void                clutter_behaviour_scale_set_bounds  (ClutterBehaviourScale *scale,
    -                                                         gdouble x_scale_start,
    -                                                         gdouble y_scale_start,
    -                                                         gdouble x_scale_end,
    -                                                         gdouble y_scale_end);
    +
    void                clutter_behaviour_scale_set_bounds  (ClutterBehaviourScale *scale,
    +                                                         gdouble x_scale_start,
    +                                                         gdouble y_scale_start,
    +                                                         gdouble x_scale_end,
    +                                                         gdouble y_scale_end);

    Sets the bounds used by scale behaviour.

    +

    +

    @@ -321,13 +384,23 @@

    clutter_behaviour_scale_get_bounds ()

    -
    void                clutter_behaviour_scale_get_bounds  (ClutterBehaviourScale *scale,
    -                                                         gdouble *x_scale_start,
    -                                                         gdouble *y_scale_start,
    -                                                         gdouble *x_scale_end,
    -                                                         gdouble *y_scale_end);
    +
    void                clutter_behaviour_scale_get_bounds  (ClutterBehaviourScale *scale,
    +                                                         gdouble *x_scale_start,
    +                                                         gdouble *y_scale_start,
    +                                                         gdouble *x_scale_end,
    +                                                         gdouble *y_scale_end);

    Retrieves the bounds used by scale behaviour.

    +

    +

    @@ -339,25 +412,25 @@ @@ -369,47 +442,63 @@

    Property Details

    The "x-scale-end" property

    -
      "x-scale-end"              gdouble               : Read / Write
    +
      "x-scale-end"              gdouble               : Read / Write

    The final scaling factor on the X axis for the actors.

    +

    +

    Allowed values: >= 0

    Default value: 1

    -

    Since 0.6

    +

    Since 0.6


    The "x-scale-start" property

    -
      "x-scale-start"            gdouble               : Read / Write
    +
      "x-scale-start"            gdouble               : Read / Write

    The initial scaling factor on the X axis for the actors.

    +

    +

    Allowed values: >= 0

    Default value: 1

    -

    Since 0.6

    +

    Since 0.6


    The "y-scale-end" property

    -
      "y-scale-end"              gdouble               : Read / Write
    +
      "y-scale-end"              gdouble               : Read / Write

    The final scaling factor on the Y axis for the actors.

    +

    +

    Allowed values: >= 0

    Default value: 1

    -

    Since 0.6

    +

    Since 0.6


    The "y-scale-start" property

    -
      "y-scale-start"            gdouble               : Read / Write
    +
      "y-scale-start"            gdouble               : Read / Write

    The initial scaling factor on the Y axis for the actors.

    +

    +

    Allowed values: >= 0

    Default value: 1

    -

    Since 0.6

    +

    Since 0.6

    + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ClutterTexture.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ClutterTexture.html @@ -8,7 +8,7 @@ - + @@ -62,16 +62,16 @@

    x_scale_start :

    return location for the initial scale factor on the X - axis, or NULL + axis, or NULL

    y_scale_start :

    return location for the initial scale factor on the Y - axis, or NULL + axis, or NULL

    x_scale_end :

    return location for the final scale factor on the X axis, - or NULL + or NULL

    y_scale_end :

    return location for the final scale factor on the Y axis, - or NULL + or NULL
    Top -  |  - Description -  |  - Object Hierarchy -  |  - Implemented Interfaces -  |  - Properties -  |  - Signals +  |  + Description +  |  + Object Hierarchy +  |  + Implemented Interfaces +  |  + Properties +  |  + Signals
    @@ -85,89 +85,190 @@

    Synopsis

    -
                        ClutterTexture;
    +
    +                    ClutterTexture;
                         ClutterTextureClass;
     enum                ClutterTextureFlags;
     enum                ClutterTextureQuality;
    -ClutterActor *      clutter_texture_new                 (void);
    -ClutterActor *      clutter_texture_new_from_file       (const gchar *filename,
    -                                                         GError **error);
    -ClutterActor *      clutter_texture_new_from_actor      (ClutterActor *actor);
    +ClutterActor *      clutter_texture_new                 (void);
    +ClutterActor *      clutter_texture_new_from_file       (const gchar *filename,
    +                                                         GError **error);
    +ClutterActor *      clutter_texture_new_from_actor      (ClutterActor *actor);
     
    -#define             CLUTTER_TEXTURE_ERROR
    +#define             CLUTTER_TEXTURE_ERROR
     enum                ClutterTextureError;
    -gboolean            clutter_texture_set_from_file       (ClutterTexture *texture,
    -                                                         const gchar *filename,
    -                                                         GError **error);
    -gboolean            clutter_texture_set_from_rgb_data   (ClutterTexture *texture,
    -                                                         const guchar *data,
    -                                                         gboolean has_alpha,
    -                                                         gint width,
    -                                                         gint height,
    -                                                         gint rowstride,
    -                                                         gint bpp,
    -                                                         ClutterTextureFlags flags,
    -                                                         GError **error);
    -gboolean            clutter_texture_set_from_yuv_data   (ClutterTexture *texture,
    -                                                         const guchar *data,
    -                                                         gint width,
    -                                                         gint height,
    -                                                         ClutterTextureFlags flags,
    -                                                         GError **error);
    -gboolean            clutter_texture_set_area_from_rgb_data
    -                                                        (ClutterTexture *texture,
    -                                                         const guchar *data,
    -                                                         gboolean has_alpha,
    -                                                         gint x,
    -                                                         gint y,
    -                                                         gint width,
    -                                                         gint height,
    -                                                         gint rowstride,
    -                                                         gint bpp,
    -                                                         ClutterTextureFlags flags,
    -                                                         GError **error);
    -void                clutter_texture_get_base_size       (ClutterTexture *texture,
    -                                                         gint *width,
    -                                                         gint *height);
    -CoglPixelFormat     clutter_texture_get_pixel_format    (ClutterTexture *texture);
    -gint                clutter_texture_get_max_tile_waste  (ClutterTexture *texture);
    -ClutterTextureQuality  clutter_texture_get_filter_quality
    -                                                        (ClutterTexture *texture);
    -void                clutter_texture_set_filter_quality  (ClutterTexture *texture,
    -                                                         ClutterTextureQuality filter_quality);
    -CoglHandle          clutter_texture_get_cogl_texture    (ClutterTexture *texture);
    -void                clutter_texture_set_cogl_texture    (ClutterTexture *texture,
    -                                                         CoglHandle cogl_tex);
    -CoglHandle          clutter_texture_get_cogl_material   (ClutterTexture *texture);
    -void                clutter_texture_set_cogl_material   (ClutterTexture *texture,
    -                                                         CoglHandle cogl_material);
    -gboolean            clutter_texture_get_sync_size       (ClutterTexture *texture);
    -void                clutter_texture_set_sync_size       (ClutterTexture *texture,
    -                                                         gboolean sync_size);
    -void                clutter_texture_get_repeat          (ClutterTexture *texture,
    -                                                         gboolean *repeat_x,
    -                                                         gboolean *repeat_y);
    -void                clutter_texture_set_repeat          (ClutterTexture *texture,
    -                                                         gboolean repeat_x,
    -                                                         gboolean repeat_y);
    -gboolean            clutter_texture_get_keep_aspect_ratio
    -                                                        (ClutterTexture *texture);
    -void                clutter_texture_set_keep_aspect_ratio
    -                                                        (ClutterTexture *texture,
    -                                                         gboolean keep_aspect);
    -gboolean            clutter_texture_get_load_async      (ClutterTexture *texture);
    -void                clutter_texture_set_load_async      (ClutterTexture *texture,
    -                                                         gboolean load_async);
    -gboolean            clutter_texture_get_load_data_async (ClutterTexture *texture);
    -void                clutter_texture_set_load_data_async (ClutterTexture *texture,
    -                                                         gboolean load_async);
    +gboolean            clutter_texture_set_from_file       (ClutterTexture *texture,
    +                                                         const gchar *filename,
    +                                                         GError **error);
    +gboolean            clutter_texture_set_from_rgb_data   (ClutterTexture *texture,
    +                                                         const guchar *data,
    +                                                         gboolean has_alpha,
    +                                                         gint width,
    +                                                         gint height,
    +                                                         gint rowstride,
    +                                                         gint bpp,
    +                                                         ClutterTextureFlags flags,
    +                                                         GError **error);
    +gboolean            clutter_texture_set_from_yuv_data   (ClutterTexture *texture,
    +                                                         const guchar *data,
    +                                                         gint width,
    +                                                         gint height,
    +                                                         ClutterTextureFlags flags,
    +                                                         GError **error);
    +gboolean            clutter_texture_set_area_from_rgb_data
    +                                                        (ClutterTexture *texture,
    +                                                         const guchar *data,
    +                                                         gboolean has_alpha,
    +                                                         gint x,
    +                                                         gint y,
    +                                                         gint width,
    +                                                         gint height,
    +                                                         gint rowstride,
    +                                                         gint bpp,
    +                                                         ClutterTextureFlags flags,
    +                                                         GError **error);
    +void                clutter_texture_get_base_size       (ClutterTexture *texture,
    +                                                         gint *width,
    +                                                         gint *height);
    +CoglPixelFormat     clutter_texture_get_pixel_format    (ClutterTexture *texture);
    +gint                clutter_texture_get_max_tile_waste  (ClutterTexture *texture);
    +ClutterTextureQuality  clutter_texture_get_filter_quality
    +                                                        (ClutterTexture *texture);
    +void                clutter_texture_set_filter_quality  (ClutterTexture *texture,
    +                                                         ClutterTextureQuality filter_quality);
    +CoglHandle          clutter_texture_get_cogl_texture    (ClutterTexture *texture);
    +void                clutter_texture_set_cogl_texture    (ClutterTexture *texture,
    +                                                         CoglHandle cogl_tex);
    +CoglHandle          clutter_texture_get_cogl_material   (ClutterTexture *texture);
    +void                clutter_texture_set_cogl_material   (ClutterTexture *texture,
    +                                                         CoglHandle cogl_material);
    +gboolean            clutter_texture_get_sync_size       (ClutterTexture *texture);
    +void                clutter_texture_set_sync_size       (ClutterTexture *texture,
    +                                                         gboolean sync_size);
    +void                clutter_texture_get_repeat          (ClutterTexture *texture,
    +                                                         gboolean *repeat_x,
    +                                                         gboolean *repeat_y);
    +void                clutter_texture_set_repeat          (ClutterTexture *texture,
    +                                                         gboolean repeat_x,
    +                                                         gboolean repeat_y);
    +gboolean            clutter_texture_get_keep_aspect_ratio
    +                                                        (ClutterTexture *texture);
    +void                clutter_texture_set_keep_aspect_ratio
    +                                                        (ClutterTexture *texture,
    +                                                         gboolean keep_aspect);
    +gboolean            clutter_texture_get_load_async      (ClutterTexture *texture);
    +void                clutter_texture_set_load_async      (ClutterTexture *texture,
    +                                                         gboolean load_async);
    +gboolean            clutter_texture_get_load_data_async (ClutterTexture *texture);
    +void                clutter_texture_set_load_data_async (ClutterTexture *texture,
    +                                                         gboolean load_async);
     

    Object Hierarchy

    -  GObject
    -   +----GInitiallyUnowned
    +  GObject
    +   +----GInitiallyUnowned
              +----ClutterActor
                    +----ClutterTexture
                          +----ClutterCairoTexture
    @@ -182,19 +283,43 @@
     

    Properties

    -  "cogl-material"            CoglHandle*           : Read / Write
    -  "cogl-texture"             CoglHandle*           : Read / Write
    -  "disable-slicing"          gboolean              : Read / Write / Construct Only
    -  "filename"                 gchar*                : Write
    -  "filter-quality"           ClutterTextureQuality  : Read / Write / Construct
    -  "keep-aspect-ratio"        gboolean              : Read / Write
    -  "load-async"               gboolean              : Write
    -  "load-data-async"          gboolean              : Write
    -  "pixel-format"             CoglPixelFormat       : Read
    -  "repeat-x"                 gboolean              : Read / Write
    -  "repeat-y"                 gboolean              : Read / Write
    -  "sync-size"                gboolean              : Read / Write
    -  "tile-waste"               gint                  : Read
    +  "cogl-material"            CoglHandle*           : Read / Write
    +  "cogl-texture"             CoglHandle*           : Read / Write
    +  "disable-slicing"          gboolean              : Read / Write / Construct Only
    +  "filename"                 gchar*                : Write
    +  "filter-quality"           ClutterTextureQuality  : Read / Write / Construct
    +  "keep-aspect-ratio"        gboolean              : Read / Write
    +  "load-async"               gboolean              : Write
    +  "load-data-async"          gboolean              : Write
    +  "pixel-format"             CoglPixelFormat       : Read
    +  "repeat-x"                 gboolean              : Read / Write
    +  "repeat-y"                 gboolean              : Read / Write
    +  "sync-size"                gboolean              : Read / Write
    +  "tile-waste"               gint                  : Read
     
    @@ -221,6 +346,8 @@ box requested using clutter_actor_set_size(). To display an area of a texture without scaling, you should set the clip area using clutter_actor_set_clip().

    +

    +

    Details

    @@ -230,6 +357,8 @@

    The ClutterTexture structure contains only private data and should be accessed using the provided API

    +

    +

    Since 0.1


    @@ -246,21 +375,23 @@

    The ClutterTextureClass structure contains only private data

    +

    +

    - + - + - + @@ -283,26 +414,28 @@

    Flags for clutter_texture_set_from_rgb_data() and clutter_texture_set_from_yuv_data().

    +

    +

    size_change ()

    size_change ()

    handler for the "size-change" signal

    pixbuf_change ()

    pixbuf_change ()

    handler for the "pixbuf-change" signal

    load_finished ()

    load_finished ()

    handler for the "load-finished" signal
    - + - + - + - + @@ -321,23 +454,25 @@

    Enumaration controlling the texture quality.

    +

    +

    CLUTTER_TEXTURE_NONE

    CLUTTER_TEXTURE_NONE

    No flags

    CLUTTER_TEXTURE_RGB_FLAG_BGR

    CLUTTER_TEXTURE_RGB_FLAG_BGR

    FIXME

    CLUTTER_TEXTURE_RGB_FLAG_PREMULT

    CLUTTER_TEXTURE_RGB_FLAG_PREMULT

    FIXME

    CLUTTER_TEXTURE_YUV_FLAG_YUV2

    CLUTTER_TEXTURE_YUV_FLAG_YUV2

    FIXME
    - + - + - + @@ -349,9 +484,11 @@

    clutter_texture_new ()

    -
    ClutterActor *      clutter_texture_new                 (void);
    +
    ClutterActor *      clutter_texture_new                 (void);

    Creates a new empty ClutterTexture object.

    +

    +

    CLUTTER_TEXTURE_QUALITY_LOW

    CLUTTER_TEXTURE_QUALITY_LOW

    fastest rendering will use nearest neighbour interpolation when rendering. good setting.

    CLUTTER_TEXTURE_QUALITY_MEDIUM

    CLUTTER_TEXTURE_QUALITY_MEDIUM

    higher quality rendering without using extra resources.

    CLUTTER_TEXTURE_QUALITY_HIGH

    CLUTTER_TEXTURE_QUALITY_HIGH

    render the texture with the best quality available using extra memory.
    @@ -364,12 +501,18 @@

    clutter_texture_new_from_file ()

    -
    ClutterActor *      clutter_texture_new_from_file       (const gchar *filename,
    -                                                         GError **error);
    +
    ClutterActor *      clutter_texture_new_from_file       (const gchar *filename,
    +                                                         GError **error);

    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.

    +

    +

    @@ -397,7 +540,7 @@

    clutter_texture_new_from_actor ()

    -
    ClutterActor *      clutter_texture_new_from_actor      (ClutterActor *actor);
    +
    ClutterActor *      clutter_texture_new_from_actor      (ClutterActor *actor);

    Creates a new ClutterTexture object with its source a prexisting actor (and associated children). The textures content will contain @@ -406,7 +549,7 @@

    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 +the CLUTTER_FEATURE_OFFSCREEN feature is supported by the current backend and the target system.

    @@ -451,10 +594,14 @@

  • Uploading pixel data to the texture (e.g by using clutter_actor_set_from_file()) will destroy the offscreen texture data and end redirection.

  • -
  • cogl_texture_get_data() with the handle returned by +

  • 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.

  • +

    +

    @@ -465,7 +612,7 @@ - @@ -475,11 +622,13 @@
    -

    CLUTTER_TEXTURE_ERROR

    +

    CLUTTER_TEXTURE_ERROR

    #define CLUTTER_TEXTURE_ERROR   (clutter_texture_error_quark ())
     

    Error domain for ClutterTexture errors

    +

    +

    Since 0.4


    @@ -493,22 +642,24 @@

    Error enumeration for ClutterTexture

    +

    +

    Returns :

    A newly created ClutterTexture object, or NULL on failure. + A newly created ClutterTexture object, or NULL on failure.
    - + - + - +

    CLUTTER_TEXTURE_ERROR_OUT_OF_MEMORY

    CLUTTER_TEXTURE_ERROR_OUT_OF_MEMORY

    OOM condition

    CLUTTER_TEXTURE_ERROR_NO_YUV

    CLUTTER_TEXTURE_ERROR_NO_YUV

    YUV operation attempted but no YUV support found

    CLUTTER_TEXTURE_ERROR_BAD_FORMAT

    CLUTTER_TEXTURE_ERROR_BAD_FORMAT

    The requested format for clutter_texture_set_from_rgb_data or clutter_texture_set_from_yuv_data is unsupported. @@ -521,20 +672,28 @@

    clutter_texture_set_from_file ()

    -
    gboolean            clutter_texture_set_from_file       (ClutterTexture *texture,
    -                                                         const gchar *filename,
    -                                                         GError **error);
    +
    gboolean            clutter_texture_set_from_file       (ClutterTexture *texture,
    +                                                         const gchar *filename,
    +                                                         GError **error);

    Sets the ClutterTexture image data from an image file. In case of -failure, FALSE is returned and error is set. +failure, FALSE is returned and error is set.

    -If "load-async" is set to TRUE, this function +If "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. "size-change" will be emitten when the size of the texture is available and "load-finished" will be emitted when the image has been loaded or if an error occurred.

    +

    +

    @@ -550,12 +709,14 @@ - - @@ -566,17 +727,35 @@

    clutter_texture_set_from_rgb_data ()

    -
    gboolean            clutter_texture_set_from_rgb_data   (ClutterTexture *texture,
    -                                                         const guchar *data,
    -                                                         gboolean has_alpha,
    -                                                         gint width,
    -                                                         gint height,
    -                                                         gint rowstride,
    -                                                         gint bpp,
    -                                                         ClutterTextureFlags flags,
    -                                                         GError **error);
    +
    gboolean            clutter_texture_set_from_rgb_data   (ClutterTexture *texture,
    +                                                         const guchar *data,
    +                                                         gboolean has_alpha,
    +                                                         gint width,
    +                                                         gint height,
    +                                                         gint rowstride,
    +                                                         gint bpp,
    +                                                         ClutterTextureFlags flags,
    +                                                         GError **error);

    Sets ClutterTexture image data.

    +

    +

    error :

    Return location for a GError, or NULL + Return location for a GError, or NULL

    Returns :

    TRUE if the image was successfully loaded and set + TRUE if the image was successfully loaded and set
    @@ -623,12 +802,14 @@ - - @@ -639,15 +820,27 @@

    clutter_texture_set_from_yuv_data ()

    -
    gboolean            clutter_texture_set_from_yuv_data   (ClutterTexture *texture,
    -                                                         const guchar *data,
    -                                                         gint width,
    -                                                         gint height,
    -                                                         ClutterTextureFlags flags,
    -                                                         GError **error);
    +
    gboolean            clutter_texture_set_from_yuv_data   (ClutterTexture *texture,
    +                                                         const guchar *data,
    +                                                         gint width,
    +                                                         gint height,
    +                                                         ClutterTextureFlags flags,
    +                                                         GError **error);

    Sets a ClutterTexture from YUV image data. If an error occurred, -FALSE is returned and error is set.

    +FALSE is returned and error is set.

    +

    +

    error :

    return location for a GError, or NULL. + return location for a GError, or NULL.

    Returns :

    TRUE on success, FALSE on failure. + TRUE on success, FALSE on failure.
    @@ -678,12 +871,14 @@ - - @@ -694,20 +889,42 @@

    clutter_texture_set_area_from_rgb_data ()

    -
    gboolean            clutter_texture_set_area_from_rgb_data
    -                                                        (ClutterTexture *texture,
    -                                                         const guchar *data,
    -                                                         gboolean has_alpha,
    -                                                         gint x,
    -                                                         gint y,
    -                                                         gint width,
    -                                                         gint height,
    -                                                         gint rowstride,
    -                                                         gint bpp,
    -                                                         ClutterTextureFlags flags,
    -                                                         GError **error);
    +
    gboolean            clutter_texture_set_area_from_rgb_data
    +                                                        (ClutterTexture *texture,
    +                                                         const guchar *data,
    +                                                         gboolean has_alpha,
    +                                                         gint x,
    +                                                         gint y,
    +                                                         gint width,
    +                                                         gint height,
    +                                                         gint rowstride,
    +                                                         gint bpp,
    +                                                         ClutterTextureFlags flags,
    +                                                         GError **error);

    Updates a sub-region of the pixel data in a ClutterTexture.

    +

    +

    error :

    Return location for a GError, or NULL. + Return location for a GError, or NULL.

    Returns :

    TRUE if the texture was successfully updated + TRUE if the texture was successfully updated
    @@ -764,12 +981,14 @@ - - @@ -780,11 +999,17 @@

    clutter_texture_get_base_size ()

    -
    void                clutter_texture_get_base_size       (ClutterTexture *texture,
    -                                                         gint *width,
    -                                                         gint *height);
    +
    void                clutter_texture_get_base_size       (ClutterTexture *texture,
    +                                                         gint *width,
    +                                                         gint *height);

    Gets the size in pixels of the untransformed underlying image

    +

    +

    error :

    return location for a GError, or NULL + return location for a GError, or NULL

    Returns :

    TRUE on success, FALSE on failure. + TRUE on success, FALSE on failure.
    @@ -795,11 +1020,11 @@ - + - +

    width :

    return location for the width, or NULL. out. return location for the width, or NULL. out.

    height :

    return location for the height, or NULL. out. return location for the height, or NULL. out.
    @@ -807,7 +1032,9 @@

    clutter_texture_get_pixel_format ()

    -
    CoglPixelFormat     clutter_texture_get_pixel_format    (ClutterTexture *texture);
    +
    CoglPixelFormat     clutter_texture_get_pixel_format    (ClutterTexture *texture);

    Retrieves the pixel format used by texture. This is equivalent to: @@ -820,6 +1047,8 @@ if (handle != COGL_INVALID_HANDLE) format = cogl_texture_get_format (handle);

    +

    +

    @@ -830,7 +1059,9 @@ - @@ -841,10 +1072,14 @@

    clutter_texture_get_max_tile_waste ()

    -
    gint                clutter_texture_get_max_tile_waste  (ClutterTexture *texture);
    +
    gint                clutter_texture_get_max_tile_waste  (ClutterTexture *texture);

    Gets the maximum waste that will be used when creating a texture or -1 if slicing is disabled.

    +

    +

    Returns :

    a CoglPixelFormat value + a CoglPixelFormat value
    @@ -867,10 +1102,12 @@

    clutter_texture_get_filter_quality ()

    -
    ClutterTextureQuality  clutter_texture_get_filter_quality
    -                                                        (ClutterTexture *texture);
    +
    ClutterTextureQuality  clutter_texture_get_filter_quality
    +                                                        (ClutterTexture *texture);

    Gets the filter quality used when scaling a texture.

    +

    +

    @@ -892,17 +1129,19 @@

    clutter_texture_set_filter_quality ()

    -
    void                clutter_texture_set_filter_quality  (ClutterTexture *texture,
    -                                                         ClutterTextureQuality filter_quality);
    +
    void                clutter_texture_set_filter_quality  (ClutterTexture *texture,
    +                                                         ClutterTextureQuality filter_quality);

    Sets the filter quality when scaling a texture. The quality is an enumeration currently the following values are supported: -CLUTTER_TEXTURE_QUALITY_LOW which is fast but only uses nearest neighbour -interpolation. CLUTTER_TEXTURE_QUALITY_MEDIUM which is computationally a +CLUTTER_TEXTURE_QUALITY_LOW which is fast but only uses nearest neighbour +interpolation. CLUTTER_TEXTURE_QUALITY_MEDIUM which is computationally a bit more expensive (bilinear interpolation), and -CLUTTER_TEXTURE_QUALITY_HIGH which uses extra texture memory resources to +CLUTTER_TEXTURE_QUALITY_HIGH which uses extra texture memory resources to improve scaled down rendering as well (by using mipmaps). The default value -is CLUTTER_TEXTURE_QUALITY_MEDIUM.

    +is CLUTTER_TEXTURE_QUALITY_MEDIUM.

    +

    +

    @@ -923,17 +1162,23 @@

    clutter_texture_get_cogl_texture ()

    -
    CoglHandle          clutter_texture_get_cogl_texture    (ClutterTexture *texture);
    +
    CoglHandle          clutter_texture_get_cogl_texture    (ClutterTexture *texture);

    Retrieves the handle to the underlying COGL texture used for drawing the actor. No extra reference is taken so if you need to keep the -handle then you should call cogl_handle_ref() on it. +handle then you should call cogl_handle_ref() on it.

    The texture handle returned is the first layer of the material handle used by the ClutterTexture. If you need to access the other layers you should use clutter_texture_get_cogl_material() instead and use the CoglMaterial API.

    +

    +

    @@ -954,8 +1199,10 @@

    clutter_texture_set_cogl_texture ()

    -
    void                clutter_texture_set_cogl_texture    (ClutterTexture *texture,
    -                                                         CoglHandle cogl_tex);
    +
    void                clutter_texture_set_cogl_texture    (ClutterTexture *texture,
    +                                                         CoglHandle cogl_tex);

    Replaces the underlying COGL texture drawn by this actor with cogl_tex. A reference to the texture is taken so if the handle is @@ -967,6 +1214,8 @@ implementation relies on being able to have a GL texture while unrealized, which means you can get away with it, but it's not correct and may change in the future.)

    +

    +

    @@ -987,11 +1236,17 @@

    clutter_texture_get_cogl_material ()

    -
    CoglHandle          clutter_texture_get_cogl_material   (ClutterTexture *texture);
    +
    CoglHandle          clutter_texture_get_cogl_material   (ClutterTexture *texture);

    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.

    +handle then you should call cogl_handle_ref() on it.

    +

    +

    @@ -1012,8 +1267,10 @@

    clutter_texture_set_cogl_material ()

    -
    void                clutter_texture_set_cogl_material   (ClutterTexture *texture,
    -                                                         CoglHandle cogl_material);
    +
    void                clutter_texture_set_cogl_material   (ClutterTexture *texture,
    +                                                         CoglHandle cogl_material);

    Replaces the underlying Cogl material drawn by this actor with cogl_material. A reference to the material is taken so if the @@ -1023,6 +1280,8 @@ texture. ClutterTexture requires that the material have a texture layer so you should set one on the material before calling this function.

    +

    +

    @@ -1043,9 +1302,13 @@

    clutter_texture_get_sync_size ()

    -
    gboolean            clutter_texture_get_sync_size       (ClutterTexture *texture);
    +
    gboolean            clutter_texture_get_sync_size       (ClutterTexture *texture);

    Retrieves the value set with clutter_texture_get_sync_size()

    +

    +

    @@ -1056,7 +1319,7 @@ - @@ -1068,11 +1331,15 @@

    clutter_texture_set_sync_size ()

    -
    void                clutter_texture_set_sync_size       (ClutterTexture *texture,
    -                                                         gboolean sync_size);
    +
    void                clutter_texture_set_sync_size       (ClutterTexture *texture,
    +                                                         gboolean sync_size);

    Sets whether texture should have the same preferred size as the underlying image data.

    +

    +

    Returns :

    TRUE if the ClutterTexture should have the same + TRUE if the ClutterTexture should have the same preferred size of the underlying image data
    @@ -1083,7 +1350,7 @@ - @@ -1094,12 +1361,18 @@

    clutter_texture_get_repeat ()

    -
    void                clutter_texture_get_repeat          (ClutterTexture *texture,
    -                                                         gboolean *repeat_x,
    -                                                         gboolean *repeat_y);
    +
    void                clutter_texture_get_repeat          (ClutterTexture *texture,
    +                                                         gboolean *repeat_x,
    +                                                         gboolean *repeat_y);

    Retrieves the horizontal and vertical repeat values set using clutter_texture_set_repeat()

    +

    +

    sync_size :

    TRUE if the texture should have the same size of the + TRUE if the texture should have the same size of the underlying image data
    @@ -1110,11 +1383,11 @@ - + - +

    repeat_x :

    return location for the horizontal repeat. out. return location for the horizontal repeat. out.

    repeat_y :

    return location for the vertical repeat. out. return location for the vertical repeat. out.
    @@ -1123,12 +1396,18 @@

    clutter_texture_set_repeat ()

    -
    void                clutter_texture_set_repeat          (ClutterTexture *texture,
    -                                                         gboolean repeat_x,
    -                                                         gboolean repeat_y);
    +
    void                clutter_texture_set_repeat          (ClutterTexture *texture,
    +                                                         gboolean repeat_x,
    +                                                         gboolean repeat_y);

    Sets whether the texture should repeat horizontally or vertically when the actor size is bigger than the image size

    +

    +

    @@ -1139,12 +1418,12 @@ - - @@ -1154,10 +1433,14 @@

    clutter_texture_get_keep_aspect_ratio ()

    -
    gboolean            clutter_texture_get_keep_aspect_ratio
    -                                                        (ClutterTexture *texture);
    +
    gboolean            clutter_texture_get_keep_aspect_ratio
    +                                                        (ClutterTexture *texture);

    Retrieves the value set using clutter_texture_get_keep_aspect_ratio()

    +

    +

    repeat_x :

    TRUE if the texture should repeat horizontally + TRUE if the texture should repeat horizontally

    repeat_y :

    TRUE if the texture should repeat vertically + TRUE if the texture should repeat vertically
    @@ -1168,7 +1451,7 @@ - @@ -1180,12 +1463,16 @@

    clutter_texture_set_keep_aspect_ratio ()

    -
    void                clutter_texture_set_keep_aspect_ratio
    -                                                        (ClutterTexture *texture,
    -                                                         gboolean keep_aspect);
    +
    void                clutter_texture_set_keep_aspect_ratio
    +                                                        (ClutterTexture *texture,
    +                                                         gboolean keep_aspect);

    Sets whether texture should have a preferred size maintaining the aspect ratio of the underlying image

    +

    +

    Returns :

    TRUE if the ClutterTexture should maintain the + TRUE if the ClutterTexture should maintain the aspect ratio of the underlying image
    @@ -1196,7 +1483,7 @@ - @@ -1206,9 +1493,13 @@

    clutter_texture_get_load_async ()

    -
    gboolean            clutter_texture_get_load_async      (ClutterTexture *texture);
    +
    gboolean            clutter_texture_get_load_async      (ClutterTexture *texture);

    Retrieves the value set using clutter_texture_get_load_async()

    +

    +

    keep_aspect :

    TRUE to maintain aspect ratio + TRUE to maintain aspect ratio
    @@ -1219,7 +1510,7 @@ - @@ -1231,16 +1522,20 @@

    clutter_texture_set_load_async ()

    -
    void                clutter_texture_set_load_async      (ClutterTexture *texture,
    -                                                         gboolean load_async);
    +
    void                clutter_texture_set_load_async      (ClutterTexture *texture,
    +                                                         gboolean load_async);

    Sets whether texture should use a worker thread to load the data -from disk asynchronously. Setting load_async to TRUE will make +from disk asynchronously. Setting load_async to TRUE will make clutter_texture_set_from_file() return immediately.

    See the "load-async" property documentation, and clutter_texture_set_load_data_async().

    +

    +

    Returns :

    TRUE if the ClutterTexture should load the data from + TRUE if the ClutterTexture should load the data from disk asynchronously
    @@ -1251,7 +1546,7 @@ - @@ -1262,9 +1557,13 @@

    clutter_texture_get_load_data_async ()

    -
    gboolean            clutter_texture_get_load_data_async (ClutterTexture *texture);
    +
    gboolean            clutter_texture_get_load_data_async (ClutterTexture *texture);

    Retrieves the value set by clutter_texture_set_load_data_async()

    +

    +

    load_async :

    TRUE if the texture should asynchronously load data + TRUE if the texture should asynchronously load data from a filename
    @@ -1275,7 +1574,7 @@ - @@ -1287,17 +1586,21 @@

    clutter_texture_set_load_data_async ()

    -
    void                clutter_texture_set_load_data_async (ClutterTexture *texture,
    -                                                         gboolean load_async);
    +
    void                clutter_texture_set_load_data_async (ClutterTexture *texture,
    +                                                         gboolean load_async);

    Sets whether texture should use a worker thread to load the data -from disk asynchronously. Setting load_async to TRUE will make +from disk asynchronously. Setting load_async to TRUE will make clutter_texture_set_from_file() block until the ClutterTexture has determined the width and height of the image data.

    See the "load-async" property documentation, and clutter_texture_set_load_async().

    +

    +

    Returns :

    TRUE if the ClutterTexture should load the image + TRUE if the ClutterTexture should load the image data from a file asynchronously
    @@ -1308,7 +1611,7 @@ - @@ -1321,47 +1624,59 @@

    Property Details

    The "cogl-material" property

    -
      "cogl-material"            CoglHandle*           : Read / Write
    +
      "cogl-material"            CoglHandle*           : Read / Write

    The underlying COGL material handle used to draw this actor.


    The "cogl-texture" property

    -
      "cogl-texture"             CoglHandle*           : Read / Write
    +
      "cogl-texture"             CoglHandle*           : Read / Write

    The underlying COGL texture handle used to draw this actor.


    The "disable-slicing" property

    -
      "disable-slicing"          gboolean              : Read / Write / Construct Only
    +
      "disable-slicing"          gboolean              : Read / Write / Construct Only

    Force the underlying texture to be singlularand not made of of smaller space saving inidivual textures.

    Default value: FALSE


    The "filename" property

    -
      "filename"                 gchar*                : Write
    +
      "filename"                 gchar*                : Write

    The full path of the file containing the texture.

    Default value: NULL


    The "filter-quality" property

    -
      "filter-quality"           ClutterTextureQuality  : Read / Write / Construct
    +
      "filter-quality"           ClutterTextureQuality  : Read / Write / Construct

    Rendering quality used when drawing the texture.

    Default value: CLUTTER_TEXTURE_QUALITY_MEDIUM


    The "keep-aspect-ratio" property

    -
      "keep-aspect-ratio"        gboolean              : Read / Write
    +
      "keep-aspect-ratio"        gboolean              : Read / Write

    Keep the aspect ratio of the texture when requesting the preferred width or height.

    Default value: FALSE


    The "load-async" property

    -
      "load-async"               gboolean              : Write
    +
      "load-async"               gboolean              : Write

    Tries to load a texture from a filename by using a local thread to perform the read operations. The initially created texture has dimensions 0x0 when @@ -1370,7 +1685,9 @@ "load-finished" signal is emitted.

    -Threading is only enabled if g_thread_init() has been called prior to +Threading is only enabled if g_thread_init() has been called prior to clutter_init(), otherwise ClutterTexture will use the main loop to load the image.

    @@ -1378,51 +1695,67 @@ The upload of the texture data on the GL pipeline is not asynchronous, as it must be performed from within the same thread that called clutter_main().

    +

    +

    Default value: FALSE

    -

    Since 1.0

    +

    Since 1.0


    The "load-data-async" property

    -
      "load-data-async"          gboolean              : Write
    +
      "load-data-async"          gboolean              : Write

    Like "load-async" but loads the width and height synchronously causing some blocking.

    +

    +

    Default value: FALSE

    -

    Since 1.0

    +

    Since 1.0


    The "pixel-format" property

    -
      "pixel-format"             CoglPixelFormat       : Read
    +
      "pixel-format"             CoglPixelFormat       : Read

    CoglPixelFormat to use.

    Default value: COGL_PIXEL_FORMAT_RGBA_8888


    The "repeat-x" property

    -
      "repeat-x"                 gboolean              : Read / Write
    +
      "repeat-x"                 gboolean              : Read / Write

    Repeat underlying pixbuf rather than scale in x direction.

    Default value: FALSE


    The "repeat-y" property

    -
      "repeat-y"                 gboolean              : Read / Write
    +
      "repeat-y"                 gboolean              : Read / Write

    Repeat underlying pixbuf rather than scale in y direction.

    Default value: FALSE


    The "sync-size" property

    -
      "sync-size"                gboolean              : Read / Write
    +
      "sync-size"                gboolean              : Read / Write

    Auto sync size of actor to underlying pixbuf dimensions.

    Default value: TRUE


    The "tile-waste" property

    -
      "tile-waste"               gint                  : Read
    +
      "tile-waste"               gint                  : Read

    Maximum waste area of a sliced texture.

    Allowed values: >= -1

    Default value: 127

    @@ -1432,13 +1765,19 @@

    Signal Details

    The "load-finished" signal

    -
    void                user_function                      (ClutterTexture *texture,
    -                                                        gpointer        error,
    -                                                        gpointer        user_data)      : Run Last
    +
    void                user_function                      (ClutterTexture *texture,
    +                                                        gpointer        error,
    +                                                        gpointer        user_data)      : Run Last

    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

    +be set, otherwise it will be NULL

    +

    +

    load_async :

    TRUE if the texture should asynchronously load data + TRUE if the texture should asynchronously load data from a filename
    @@ -1449,7 +1788,7 @@ - @@ -1458,16 +1797,20 @@

    error :

    A set error, or NULL + A set error, or NULL
    -

    Since 1.0

    +

    Since 1.0


    The "pixbuf-change" signal

    -
    void                user_function                      (ClutterTexture *texture,
    -                                                        gpointer        user_data)      : Run Last
    +
    void                user_function                      (ClutterTexture *texture,
    +                                                        gpointer        user_data)      : Run Last

    The ::pixbuf-change signal is emitted each time the pixbuf used by texture changes.

    +

    +

    @@ -1486,14 +1829,22 @@

    The "size-change" signal

    -
    void                user_function                      (ClutterTexture *texture,
    -                                                        gint            width,
    -                                                        gint            height,
    -                                                        gpointer        user_data)      : Run Last
    +
    void                user_function                      (ClutterTexture *texture,
    +                                                        gint            width,
    +                                                        gint            height,
    +                                                        gpointer        user_data)      : Run Last

    The ::size-change signal is emitted each time the size of the pixbuf used by texture changes. The new size is given as argument to the callback.

    +

    +

    @@ -1523,6 +1874,6 @@ + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ClutterGroup.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ClutterGroup.html @@ -8,7 +8,7 @@ - + @@ -62,12 +62,12 @@
    Top -  |  - Description -  |  - Object Hierarchy -  |  - Implemented Interfaces +  |  + Description +  |  + Object Hierarchy +  |  + Implemented Interfaces
    @@ -81,20 +81,29 @@

    Object Hierarchy

    -  GObject
    -   +----GInitiallyUnowned
    +  GObject
    +   +----GInitiallyUnowned
              +----ClutterActor
                    +----ClutterGroup
                          +----ClutterStage
    @@ -126,6 +135,8 @@
     the visible area of a ClutterGroup to a specified allocation is to
     explicitly set the size of the ClutterGroup and then use the
     "clip-to-allocation" property.

    +

    +

    Details

    @@ -135,6 +146,8 @@

    The ClutterGroup structure contains only private data and should be accessed using the provided API

    +

    +

    Since 0.1


    @@ -145,14 +158,18 @@

    The ClutterGroupClass structure contains only private data

    +

    +

    Since 0.1


    clutter_group_new ()

    -
    ClutterActor *      clutter_group_new                   (void);
    +
    ClutterActor *      clutter_group_new                   (void);

    Create a new ClutterGroup.

    +

    +

    @@ -165,9 +182,11 @@

    clutter_group_remove_all ()

    -
    void                clutter_group_remove_all            (ClutterGroup *group);
    +
    void                clutter_group_remove_all            (ClutterGroup *group);

    Removes all children actors from the ClutterGroup.

    +

    +

    @@ -180,9 +199,13 @@

    clutter_group_get_n_children ()

    -
    gint                clutter_group_get_n_children        (ClutterGroup *self);
    +
    gint                clutter_group_get_n_children        (ClutterGroup *self);

    Gets the number of actors held in the group.

    +

    +

    @@ -204,10 +227,14 @@

    clutter_group_get_nth_child ()

    -
    ClutterActor *      clutter_group_get_nth_child         (ClutterGroup *self,
    -                                                         gint index_);
    +
    ClutterActor *      clutter_group_get_nth_child         (ClutterGroup *self,
    +                                                         gint index_);

    Gets a groups child held at index_ in stack.

    +

    +

    @@ -223,7 +250,7 @@ - +

    Returns :

    transfer none. transfer none. transfer none. transfer none.
    @@ -233,6 +260,6 @@
    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ClutterAnimator.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ClutterAnimator.html @@ -8,7 +8,7 @@ - + @@ -62,14 +62,14 @@ Top -  |  - Description -  |  - Object Hierarchy -  |  - Implemented Interfaces -  |  - Properties +  |  + Description +  |  + Object Hierarchy +  |  + Implemented Interfaces +  |  + Properties
    @@ -83,79 +83,162 @@

    Synopsis

    -
                        ClutterAnimator;
    +
    +                    ClutterAnimator;
                         ClutterAnimatorClass;
    -ClutterAnimator *   clutter_animator_new                (void);
    -void                clutter_animator_set                (ClutterAnimator *animator,
    -                                                         gpointer first_object,
    -                                                         const gchar *first_property_name,
    -                                                         guint first_mode,
    -                                                         gdouble first_progress,
    +ClutterAnimator *   clutter_animator_new                (void);
    +void                clutter_animator_set                (ClutterAnimator *animator,
    +                                                         gpointer first_object,
    +                                                         const gchar *first_property_name,
    +                                                         guint first_mode,
    +                                                         gdouble first_progress,
                                                              ...);
    -ClutterAnimator *   clutter_animator_set_key            (ClutterAnimator *animator,
    -                                                         GObject *object,
    -                                                         const gchar *property_name,
    -                                                         guint mode,
    -                                                         gdouble progress,
    -                                                         const GValue *value);
    -void                clutter_animator_remove_key         (ClutterAnimator *animator,
    -                                                         GObject *object,
    -                                                         const gchar *property_name,
    -                                                         gdouble progress);
    -GList *             clutter_animator_get_keys           (ClutterAnimator *animator,
    -                                                         GObject *object,
    -                                                         const gchar *property_name,
    -                                                         gdouble progress);
    -ClutterTimeline *   clutter_animator_start              (ClutterAnimator *animator);
    -gboolean            clutter_animator_compute_value      (ClutterAnimator *animator,
    -                                                         GObject *object,
    -                                                         const gchar *property_name,
    -                                                         gdouble progress,
    -                                                         GValue *value);
    +ClutterAnimator *   clutter_animator_set_key            (ClutterAnimator *animator,
    +                                                         GObject *object,
    +                                                         const gchar *property_name,
    +                                                         guint mode,
    +                                                         gdouble progress,
    +                                                         const GValue *value);
    +void                clutter_animator_remove_key         (ClutterAnimator *animator,
    +                                                         GObject *object,
    +                                                         const gchar *property_name,
    +                                                         gdouble progress);
    +GList *             clutter_animator_get_keys           (ClutterAnimator *animator,
    +                                                         GObject *object,
    +                                                         const gchar *property_name,
    +                                                         gdouble progress);
    +ClutterTimeline *   clutter_animator_start              (ClutterAnimator *animator);
    +gboolean            clutter_animator_compute_value      (ClutterAnimator *animator,
    +                                                         GObject *object,
    +                                                         const gchar *property_name,
    +                                                         gdouble progress,
    +                                                         GValue *value);
     
    -void                clutter_animator_set_timeline       (ClutterAnimator *animator,
    -                                                         ClutterTimeline *timeline);
    -ClutterTimeline *   clutter_animator_get_timeline       (ClutterAnimator *animator);
    -void                clutter_animator_set_duration       (ClutterAnimator *animator,
    -                                                         guint duration);
    -guint               clutter_animator_get_duration       (ClutterAnimator *animator);
    +void                clutter_animator_set_timeline       (ClutterAnimator *animator,
    +                                                         ClutterTimeline *timeline);
    +ClutterTimeline *   clutter_animator_get_timeline       (ClutterAnimator *animator);
    +void                clutter_animator_set_duration       (ClutterAnimator *animator,
    +                                                         guint duration);
    +guint               clutter_animator_get_duration       (ClutterAnimator *animator);
     
    -void                clutter_animator_property_set_ease_in
    -                                                        (ClutterAnimator *animator,
    -                                                         GObject *object,
    -                                                         const gchar *property_name,
    -                                                         gboolean ease_in);
    -gboolean            clutter_animator_property_get_ease_in
    -                                                        (ClutterAnimator *animator,
    -                                                         GObject *object,
    -                                                         const gchar *property_name);
    +void                clutter_animator_property_set_ease_in
    +                                                        (ClutterAnimator *animator,
    +                                                         GObject *object,
    +                                                         const gchar *property_name,
    +                                                         gboolean ease_in);
    +gboolean            clutter_animator_property_get_ease_in
    +                                                        (ClutterAnimator *animator,
    +                                                         GObject *object,
    +                                                         const gchar *property_name);
     enum                ClutterInterpolation;
    -void                clutter_animator_property_set_interpolation
    -                                                        (ClutterAnimator *animator,
    -                                                         GObject *object,
    -                                                         const gchar *property_name,
    -                                                         ClutterInterpolation interpolation);
    -ClutterInterpolation  clutter_animator_property_get_interpolation
    -                                                        (ClutterAnimator *animator,
    -                                                         GObject *object,
    -                                                         const gchar *property_name);
    +void                clutter_animator_property_set_interpolation
    +                                                        (ClutterAnimator *animator,
    +                                                         GObject *object,
    +                                                         const gchar *property_name,
    +                                                         ClutterInterpolation interpolation);
    +ClutterInterpolation  clutter_animator_property_get_interpolation
    +                                                        (ClutterAnimator *animator,
    +                                                         GObject *object,
    +                                                         const gchar *property_name);
     
                         ClutterAnimatorKey;
    -GObject *           clutter_animator_key_get_object     (const ClutterAnimatorKey *key);
    -const gchar *       clutter_animator_key_get_property_name
    -                                                        (const ClutterAnimatorKey *key);
    -GType               clutter_animator_key_get_property_type
    -                                                        (const ClutterAnimatorKey *key);
    -gulong              clutter_animator_key_get_mode       (const ClutterAnimatorKey *key);
    -gdouble             clutter_animator_key_get_progress   (const ClutterAnimatorKey *key);
    -gboolean            clutter_animator_key_get_value      (const ClutterAnimatorKey *key,
    -                                                         GValue *value);
    +GObject *           clutter_animator_key_get_object     (const ClutterAnimatorKey *key);
    +const gchar *       clutter_animator_key_get_property_name
    +                                                        (const ClutterAnimatorKey *key);
    +GType               clutter_animator_key_get_property_type
    +                                                        (const ClutterAnimatorKey *key);
    +gulong              clutter_animator_key_get_mode       (const ClutterAnimatorKey *key);
    +gdouble             clutter_animator_key_get_progress   (const ClutterAnimatorKey *key);
    +gboolean            clutter_animator_key_get_value      (const ClutterAnimatorKey *key,
    +                                                         GValue *value);
     

    Object Hierarchy

    -  GObject
    +  GObject
        +----ClutterAnimator
     
    @@ -168,16 +251,22 @@

    Properties

    -  "duration"                 guint                 : Read / Write
    -  "timeline"                 ClutterTimeline*      : Read / Write
    +  "duration"                 guint                 : Read / Write
    +  "timeline"                 ClutterTimeline*      : Read / Write
     

    Description

    ClutterAnimator is an object providing declarative animations for -GObject properties belonging to one or more GObjects to -ClutterIntervals. +GObject properties belonging to one or more GObjects to +ClutterIntervals.

    ClutterAnimator is used to build and describe complex animations @@ -190,7 +279,9 @@

    Key Frames

    Every animation handled by a ClutterAnimator can be - described in terms of "key frames". For each GObject property + described in terms of "key frames". For each GObject property there can be multiple key frames, each one defined by the end value for the property to be computed starting from the current value to a specific point in time, using a given easing @@ -275,6 +366,8 @@

    ClutterAnimator is available since Clutter 1.2

    +

    +

    Details

    @@ -284,6 +377,8 @@

    The ClutterAnimator structure contains only private data and should be accessed using the provided API

    +

    +

    Since 1.2


    @@ -294,14 +389,18 @@

    The ClutterAnimatorClass structure contains only private data

    +

    +

    Since 1.2


    clutter_animator_new ()

    -
    ClutterAnimator *   clutter_animator_new                (void);
    +
    ClutterAnimator *   clutter_animator_new                (void);

    Creates a new ClutterAnimator instance

    +

    +

    @@ -316,11 +415,19 @@

    clutter_animator_set ()

    -
    void                clutter_animator_set                (ClutterAnimator *animator,
    -                                                         gpointer first_object,
    -                                                         const gchar *first_property_name,
    -                                                         guint first_mode,
    -                                                         gdouble first_progress,
    +
    void                clutter_animator_set                (ClutterAnimator *animator,
    +                                                         gpointer first_object,
    +                                                         const gchar *first_property_name,
    +                                                         guint first_mode,
    +                                                         gdouble first_progress,
                                                              ...);

    Adds multiple keys to a ClutterAnimator, specifying the value a given @@ -331,6 +438,8 @@

    If a given (object, property, progress) tuple already exist the mode and value will be replaced with the new values.

    +

    +

    @@ -341,7 +450,9 @@ - @@ -364,7 +475,7 @@ @@ -374,18 +485,30 @@

    clutter_animator_set_key ()

    -
    ClutterAnimator *   clutter_animator_set_key            (ClutterAnimator *animator,
    -                                                         GObject *object,
    -                                                         const gchar *property_name,
    -                                                         guint mode,
    -                                                         gdouble progress,
    -                                                         const GValue *value);
    +
    ClutterAnimator *   clutter_animator_set_key            (ClutterAnimator *animator,
    +                                                         GObject *object,
    +                                                         const gchar *property_name,
    +                                                         guint mode,
    +                                                         gdouble progress,
    +                                                         const GValue *value);

    Sets a single key in the ClutterAnimator for the property_name of object at progress.

    See also: clutter_animator_set()

    +

    +

    first_object :

    a GObject + a GObject

    ... :

    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 + progress, value) tuples, followed by NULL
    @@ -396,7 +519,9 @@ - @@ -422,7 +547,7 @@ - +

    object :

    a GObject + a GObject

    Returns :

    The animator instance. transfer none. The animator instance. transfer none.
    @@ -431,12 +556,20 @@

    clutter_animator_remove_key ()

    -
    void                clutter_animator_remove_key         (ClutterAnimator *animator,
    -                                                         GObject *object,
    -                                                         const gchar *property_name,
    -                                                         gdouble progress);
    +
    void                clutter_animator_remove_key         (ClutterAnimator *animator,
    +                                                         GObject *object,
    +                                                         const gchar *property_name,
    +                                                         gdouble progress);

    Removes all keys matching the conditions specificed in the arguments.

    +

    +

    @@ -447,11 +580,13 @@ - + - + @@ -466,13 +601,23 @@

    clutter_animator_get_keys ()

    -
    GList *             clutter_animator_get_keys           (ClutterAnimator *animator,
    -                                                         GObject *object,
    -                                                         const gchar *property_name,
    -                                                         gdouble progress);
    +
    GList *             clutter_animator_get_keys           (ClutterAnimator *animator,
    +                                                         GObject *object,
    +                                                         const gchar *property_name,
    +                                                         gdouble progress);

    Returns a list of pointers to opaque structures with accessor functions that describe the keys added to an animator.

    +

    +

    object :

    a GObject to search for, or NULL for all. allow-none. a GObject to search for, or NULL for all. allow-none.

    property_name :

    allow-none. allow-none. allow-none. allow-none.

    progress :

    @@ -483,11 +628,13 @@ - + - + @@ -497,7 +644,7 @@ - +

    object :

    a GObject to search for, or NULL for all objects. allow-none. a GObject to search for, or NULL for all objects. allow-none.

    property_name :

    allow-none. allow-none. allow-none. allow-none.

    progress :

    Returns :

    transfer container) (element-type ClutterAnimatorKey. transfer container. element-type ClutterAnimatorKey. transfer container) (element-type ClutterAnimatorKey. transfer container. element-type ClutterAnimatorKey.
    @@ -506,10 +653,12 @@

    clutter_animator_start ()

    -
    ClutterTimeline *   clutter_animator_start              (ClutterAnimator *animator);
    +
    ClutterTimeline *   clutter_animator_start              (ClutterAnimator *animator);

    Start the ClutterAnimator, this is a thin wrapper that rewinds and starts the animators current timeline.

    +

    +

    @@ -531,17 +680,29 @@

    clutter_animator_compute_value ()

    -
    gboolean            clutter_animator_compute_value      (ClutterAnimator *animator,
    -                                                         GObject *object,
    -                                                         const gchar *property_name,
    -                                                         gdouble progress,
    -                                                         GValue *value);
    +
    gboolean            clutter_animator_compute_value      (ClutterAnimator *animator,
    +                                                         GObject *object,
    +                                                         const gchar *property_name,
    +                                                         gdouble progress,
    +                                                         GValue *value);

    Compute the value for a managed property at a given progress.

    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.

    +

    +

    @@ -552,7 +713,9 @@ - @@ -572,9 +735,11 @@ - @@ -585,10 +750,12 @@

    clutter_animator_set_timeline ()

    -
    void                clutter_animator_set_timeline       (ClutterAnimator *animator,
    -                                                         ClutterTimeline *timeline);
    +
    void                clutter_animator_set_timeline       (ClutterAnimator *animator,
    +                                                         ClutterTimeline *timeline);

    Sets an external timeline that will be used for driving the animation

    +

    +

    object :

    a GObject + a GObject

    Returns :

    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 + 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
    @@ -609,9 +776,11 @@

    clutter_animator_get_timeline ()

    -
    ClutterTimeline *   clutter_animator_get_timeline       (ClutterAnimator *animator);
    +
    ClutterTimeline *   clutter_animator_get_timeline       (ClutterAnimator *animator);

    Get the timeline hooked up for driving the ClutterAnimator

    +

    +

    @@ -622,7 +791,7 @@ - +

    Returns :

    the ClutterTimeline that drives the animator. transfer none. the ClutterTimeline that drives the animator. transfer none.
    @@ -631,11 +800,15 @@

    clutter_animator_set_duration ()

    -
    void                clutter_animator_set_duration       (ClutterAnimator *animator,
    -                                                         guint duration);
    +
    void                clutter_animator_set_duration       (ClutterAnimator *animator,
    +                                                         guint duration);

    Runs the timeline of the ClutterAnimator with a duration in msecs as specified.

    +

    +

    @@ -656,9 +829,13 @@

    clutter_animator_get_duration ()

    -
    guint               clutter_animator_get_duration       (ClutterAnimator *animator);
    +
    guint               clutter_animator_get_duration       (ClutterAnimator *animator);

    Retrieves the current duration of an animator

    +

    +

    @@ -680,13 +857,21 @@

    clutter_animator_property_set_ease_in ()

    -
    void                clutter_animator_property_set_ease_in
    -                                                        (ClutterAnimator *animator,
    -                                                         GObject *object,
    -                                                         const gchar *property_name,
    -                                                         gboolean ease_in);
    +
    void                clutter_animator_property_set_ease_in
    +                                                        (ClutterAnimator *animator,
    +                                                         GObject *object,
    +                                                         const gchar *property_name,
    +                                                         gboolean ease_in);

    Sets whether a property value is to be eased into the animation.

    +

    +

    @@ -697,7 +882,9 @@ - @@ -717,12 +904,20 @@

    clutter_animator_property_get_ease_in ()

    -
    gboolean            clutter_animator_property_get_ease_in
    -                                                        (ClutterAnimator *animator,
    -                                                         GObject *object,
    -                                                         const gchar *property_name);
    +
    gboolean            clutter_animator_property_get_ease_in
    +                                                        (ClutterAnimator *animator,
    +                                                         GObject *object,
    +                                                         const gchar *property_name);

    Checks if a property value is to be eased into the animation.

    +

    +

    object :

    a GObject + a GObject
    @@ -733,7 +928,9 @@ - @@ -743,7 +940,7 @@ - @@ -761,16 +958,18 @@

    The mode of interpolation between key frames

    +

    +

    object :

    a GObject + a GObject

    Returns :

    TRUE if the property is eased in + TRUE if the property is eased in
    - + - + @@ -781,16 +980,22 @@

    clutter_animator_property_set_interpolation ()

    -
    void                clutter_animator_property_set_interpolation
    -                                                        (ClutterAnimator *animator,
    -                                                         GObject *object,
    -                                                         const gchar *property_name,
    -                                                         ClutterInterpolation interpolation);
    +
    void                clutter_animator_property_set_interpolation
    +                                                        (ClutterAnimator *animator,
    +                                                         GObject *object,
    +                                                         const gchar *property_name,
    +                                                         ClutterInterpolation interpolation);

    -Set the interpolation method to use, CLUTTER_INTERPOLATION_LINEAR causes +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 +CLUTTER_INTERPOLATION_CUBIC causes the values to smoothly change between the values.

    +

    +

    CLUTTER_INTERPOLATION_LINEAR

    CLUTTER_INTERPOLATION_LINEAR

    linear interpolation

    CLUTTER_INTERPOLATION_CUBIC

    CLUTTER_INTERPOLATION_CUBIC

    cubic interpolation
    @@ -801,7 +1006,9 @@ - @@ -821,13 +1028,19 @@

    clutter_animator_property_get_interpolation ()

    -
    ClutterInterpolation  clutter_animator_property_get_interpolation
    -                                                        (ClutterAnimator *animator,
    -                                                         GObject *object,
    -                                                         const gchar *property_name);
    +
    ClutterInterpolation  clutter_animator_property_get_interpolation
    +                                                        (ClutterAnimator *animator,
    +                                                         GObject *object,
    +                                                         const gchar *property_name);

    Get the interpolation used by animator for a property on a particular object.

    +

    +

    object :

    a GObject + a GObject
    @@ -838,7 +1051,9 @@ - @@ -861,14 +1076,20 @@
    typedef struct _ClutterAnimatorKey ClutterAnimatorKey;

    A key frame inside a ClutterAnimator

    +

    +

    Since 1.2


    clutter_animator_key_get_object ()

    -
    GObject *           clutter_animator_key_get_object     (const ClutterAnimatorKey *key);
    +
    GObject *           clutter_animator_key_get_object     (const ClutterAnimatorKey *key);

    Retrieves the object a key applies to.

    +

    +

    object :

    a GObject + a GObject
    @@ -879,7 +1100,7 @@ - +

    Returns :

    the object an animator_key exist for.. transfer none. the object an animator_key exist for.. transfer none.
    @@ -888,10 +1109,14 @@

    clutter_animator_key_get_property_name ()

    -
    const gchar *       clutter_animator_key_get_property_name
    -                                                        (const ClutterAnimatorKey *key);
    +
    const gchar *       clutter_animator_key_get_property_name
    +                                                        (const ClutterAnimatorKey *key);

    Retrieves the name of the property a key applies to.

    +

    +

    @@ -913,14 +1138,22 @@

    clutter_animator_key_get_property_type ()

    -
    GType               clutter_animator_key_get_property_type
    -                                                        (const ClutterAnimatorKey *key);
    -

    -Retrieves the GType of the property a key applies to +

    GType               clutter_animator_key_get_property_type
    +                                                        (const ClutterAnimatorKey *key);
    +

    +Retrieves the GType of the property a key applies to

    -You can use this type to initialize the GValue to pass to +You can use this type to initialize the GValue to pass to clutter_animator_key_get_value()

    +

    +

    @@ -931,7 +1164,9 @@ - @@ -942,12 +1177,16 @@

    clutter_animator_key_get_mode ()

    -
    gulong              clutter_animator_key_get_mode       (const ClutterAnimatorKey *key);
    +
    gulong              clutter_animator_key_get_mode       (const ClutterAnimatorKey *key);

    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.

    +

    +

    Returns :

    the GType of the property + the GType of the property
    @@ -969,9 +1208,13 @@

    clutter_animator_key_get_progress ()

    -
    gdouble             clutter_animator_key_get_progress   (const ClutterAnimatorKey *key);
    +
    gdouble             clutter_animator_key_get_progress   (const ClutterAnimatorKey *key);

    Retrieves the progress of an clutter_animator_key

    +

    +

    @@ -993,18 +1236,28 @@

    clutter_animator_key_get_value ()

    -
    gboolean            clutter_animator_key_get_value      (const ClutterAnimatorKey *key,
    -                                                         GValue *value);
    +
    gboolean            clutter_animator_key_get_value      (const ClutterAnimatorKey *key,
    +                                                         GValue *value);

    Retrieves a copy of the value for a ClutterAnimatorKey.

    -The passed in GValue needs to be already initialized for the value +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.

    +Use g_value_unset() when done.

    +

    +

    @@ -1015,13 +1268,17 @@ - - @@ -1034,31 +1291,37 @@

    Property Details

    The "duration" property

    -
      "duration"                 guint                 : Read / Write
    +
      "duration"                 guint                 : Read / Write

    The duration of the ClutterTimeline used by the ClutterAnimator to drive the animation

    +

    +

    Default value: 2000

    -

    Since 1.2

    +

    Since 1.2


    The "timeline" property

    -
      "timeline"                 ClutterTimeline*      : Read / Write
    +
      "timeline"                 ClutterTimeline*      : Read / Write

    The ClutterTimeline used by the ClutterAnimator to drive the animation

    -

    Since 1.2

    +

    +

    +

    Since 1.2

    + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ClutterBehaviourPath.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ClutterBehaviourPath.html @@ -8,7 +8,7 @@ - + @@ -62,16 +62,16 @@

    value :

    a GValue initialized with the correct type for the animator key + a GValue initialized with the correct type for the animator key

    Returns :

    TRUE if the passed GValue was successfully set, and - FALSE otherwise + TRUE if the passed GValue was successfully set, and + FALSE otherwise
    Top -  |  - Description -  |  - Object Hierarchy -  |  - Implemented Interfaces -  |  - Properties -  |  - Signals +  |  + Description +  |  + Object Hierarchy +  |  + Implemented Interfaces +  |  + Properties +  |  + Signals
    @@ -85,32 +85,41 @@

    Object Hierarchy

    -  GObject
    +  GObject
        +----ClutterBehaviour
              +----ClutterBehaviourPath
     
    @@ -124,7 +133,7 @@

    Properties

    -  "path"                     ClutterPath*          : Read / Write
    +  "path"                     ClutterPath*          : Read / Write
     
    @@ -141,7 +150,7 @@

    A path is described by a ClutterPath object. The path can contain straight line parts and bezier curves. If the path contains -CLUTTER_PATH_MOVE_TO parts then the actors will jump to those +CLUTTER_PATH_MOVE_TO parts then the actors will jump to those coordinates. This can be used make disjoint paths.

    @@ -173,6 +182,8 @@

    ClutterBehaviourPath is available since Clutter 0.2

    +

    +

    Details

    @@ -182,6 +193,8 @@

    The ClutterBehaviourPath structure contains only private data and should be accessed using the provided API

    +

    +

    Since 0.2


    @@ -194,10 +207,12 @@

    The ClutterBehaviourPathClass struct contains only private data

    +

    +

    - + @@ -208,8 +223,8 @@

    clutter_behaviour_path_new ()

    -
    ClutterBehaviour *  clutter_behaviour_path_new          (ClutterAlpha *alpha,
    -                                                         ClutterPath *path);
    +
    ClutterBehaviour *  clutter_behaviour_path_new          (ClutterAlpha *alpha,
    +                                                         ClutterPath *path);

    Creates a new path behaviour. You can use this behaviour to drive actors along the nodes of a path, described by path. @@ -217,17 +232,19 @@

    This will claim the floating reference on the ClutterPath so you do not need to unref if it.

    +

    +

    knot_reached ()

    knot_reached ()

    signal class handler for the ClutterBehaviourPath::knot_reached signal
    - - @@ -243,12 +260,16 @@

    clutter_behaviour_path_new_with_description ()

    -
    ClutterBehaviour *  clutter_behaviour_path_new_with_description
    -                                                        (ClutterAlpha *alpha,
    -                                                         const gchar *desc);
    +
    ClutterBehaviour *  clutter_behaviour_path_new_with_description
    +                                                        (ClutterAlpha *alpha,
    +                                                         const gchar *desc);

    Creates a new path behaviour using the path described by desc. See clutter_path_add_string() for a description of the format.

    +

    +

    alpha :

    a ClutterAlpha, or NULL + a ClutterAlpha, or NULL

    path :

    a ClutterPath or NULL for an empty path + a ClutterPath or NULL for an empty path
    @@ -275,18 +296,22 @@

    clutter_behaviour_path_new_with_knots ()

    -
    ClutterBehaviour *  clutter_behaviour_path_new_with_knots
    -                                                        (ClutterAlpha *alpha,
    -                                                         const ClutterKnot *knots,
    -                                                         guint n_knots);
    +
    ClutterBehaviour *  clutter_behaviour_path_new_with_knots
    +                                                        (ClutterAlpha *alpha,
    +                                                         const ClutterKnot *knots,
    +                                                         guint n_knots);

    Creates a new path behaviour that will make the actors visit all of the given knots in order with straight lines in between.

    A path will be created where the first knot is used in a -CLUTTER_PATH_MOVE_TO and the subsequent knots are used in -CLUTTER_PATH_LINE_TOs.

    +CLUTTER_PATH_MOVE_TO and the subsequent knots are used in +CLUTTER_PATH_LINE_TOs.

    +

    +

    @@ -318,12 +343,14 @@

    clutter_behaviour_path_set_path ()

    -
    void                clutter_behaviour_path_set_path     (ClutterBehaviourPath *pathb,
    -                                                         ClutterPath *path);
    +
    void                clutter_behaviour_path_set_path     (ClutterBehaviourPath *pathb,
    +                                                         ClutterPath *path);

    Change the path that the actors will follow. This will take the floating reference on the ClutterPath so you do not need to unref it.

    +

    +

    @@ -344,9 +371,11 @@

    clutter_behaviour_path_get_path ()

    -
    ClutterPath *       clutter_behaviour_path_get_path     (ClutterBehaviourPath *pathb);
    +
    ClutterPath *       clutter_behaviour_path_get_path     (ClutterBehaviourPath *pathb);

    Get the current path of the behaviour

    +

    +

    @@ -357,7 +386,7 @@ - +

    Returns :

    the path. transfer none. the path. transfer none.
    @@ -373,16 +402,22 @@

    Point in a path behaviour.

    +

    +

    - + - + @@ -393,9 +428,11 @@

    clutter_knot_copy ()

    -
    ClutterKnot *       clutter_knot_copy                   (const ClutterKnot *knot);
    +
    ClutterKnot *       clutter_knot_copy                   (const ClutterKnot *knot);

    Makes an allocated copy of a knot.

    +

    +

    gint x;

    gint x;

    X coordinate of the knot

    gint y;

    gint y;

    Y coordinate of the knot
    @@ -417,9 +454,11 @@

    clutter_knot_free ()

    -
    void                clutter_knot_free                   (ClutterKnot *knot);
    +
    void                clutter_knot_free                   (ClutterKnot *knot);

    Frees the memory of an allocated knot.

    +

    +

    @@ -433,10 +472,14 @@

    clutter_knot_equal ()

    -
    gboolean            clutter_knot_equal                  (const ClutterKnot *knot_a,
    -                                                         const ClutterKnot *knot_b);
    +
    gboolean            clutter_knot_equal                  (const ClutterKnot *knot_a,
    +                                                         const ClutterKnot *knot_b);

    Compares to knot and checks if the point to the same location.

    +

    +

    @@ -452,7 +495,7 @@ - @@ -465,7 +508,7 @@

    Property Details

    The "path" property

    -
      "path"                     ClutterPath*          : Read / Write
    +
      "path"                     ClutterPath*          : Read / Write

    The ClutterPath object representing the path to animate along.

    @@ -473,12 +516,18 @@

    Signal Details

    The "knot-reached" signal

    -
    void                user_function                      (ClutterBehaviourPath *pathb,
    -                                                        guint                 knot_num,
    -                                                        gpointer              user_data)      : Run Last
    +
    void                user_function                      (ClutterBehaviourPath *pathb,
    +                                                        guint                 knot_num,
    +                                                        gpointer              user_data)      : Run Last

    This signal is emitted each time a node defined inside the path is reached.

    +

    +

    Returns :

    TRUE if the knots point to the same location. + TRUE if the knots point to the same location.
    @@ -498,12 +547,12 @@
    -

    Since 0.2

    +

    Since 0.2

    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/additionaldocs.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/additionaldocs.html @@ -8,7 +8,7 @@ - + @@ -85,6 +85,6 @@
    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ClutterPath.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ClutterPath.html @@ -8,7 +8,7 @@ - + @@ -62,12 +62,12 @@ Top -  |  - Description -  |  - Object Hierarchy -  |  - Properties +  |  + Description +  |  + Object Hierarchy +  |  + Properties
    @@ -82,95 +82,184 @@

    Synopsis

    -
                        ClutterPath;
    +
    +                    ClutterPath;
                         ClutterPathClass;
    -void                (*ClutterPathCallback)              (const ClutterPathNode *node,
    -                                                         gpointer data);
    +void                (*ClutterPathCallback)              (const ClutterPathNode *node,
    +                                                         gpointer data);
     enum                ClutterPathNodeType;
    -ClutterPath *       clutter_path_new                    (void);
    -ClutterPath *       clutter_path_new_with_description   (const gchar *desc);
    +ClutterPath *       clutter_path_new                    (void);
    +ClutterPath *       clutter_path_new_with_description   (const gchar *desc);
     
    -void                clutter_path_add_move_to            (ClutterPath *path,
    -                                                         gint x,
    -                                                         gint y);
    -void                clutter_path_add_rel_move_to        (ClutterPath *path,
    -                                                         gint x,
    -                                                         gint y);
    -void                clutter_path_add_line_to            (ClutterPath *path,
    -                                                         gint x,
    -                                                         gint y);
    -void                clutter_path_add_rel_line_to        (ClutterPath *path,
    -                                                         gint x,
    -                                                         gint y);
    -void                clutter_path_add_curve_to           (ClutterPath *path,
    -                                                         gint x_1,
    -                                                         gint y_1,
    -                                                         gint x_2,
    -                                                         gint y_2,
    -                                                         gint x_3,
    -                                                         gint y_3);
    -void                clutter_path_add_rel_curve_to       (ClutterPath *path,
    -                                                         gint x_1,
    -                                                         gint y_1,
    -                                                         gint x_2,
    -                                                         gint y_2,
    -                                                         gint x_3,
    -                                                         gint y_3);
    -void                clutter_path_add_close              (ClutterPath *path);
    -gboolean            clutter_path_add_string             (ClutterPath *path,
    -                                                         const gchar *str);
    -void                clutter_path_add_node               (ClutterPath *path,
    -                                                         const ClutterPathNode *node);
    -void                clutter_path_add_cairo_path         (ClutterPath *path,
    -                                                         const cairo_path_t *cpath);
    +void                clutter_path_add_move_to            (ClutterPath *path,
    +                                                         gint x,
    +                                                         gint y);
    +void                clutter_path_add_rel_move_to        (ClutterPath *path,
    +                                                         gint x,
    +                                                         gint y);
    +void                clutter_path_add_line_to            (ClutterPath *path,
    +                                                         gint x,
    +                                                         gint y);
    +void                clutter_path_add_rel_line_to        (ClutterPath *path,
    +                                                         gint x,
    +                                                         gint y);
    +void                clutter_path_add_curve_to           (ClutterPath *path,
    +                                                         gint x_1,
    +                                                         gint y_1,
    +                                                         gint x_2,
    +                                                         gint y_2,
    +                                                         gint x_3,
    +                                                         gint y_3);
    +void                clutter_path_add_rel_curve_to       (ClutterPath *path,
    +                                                         gint x_1,
    +                                                         gint y_1,
    +                                                         gint x_2,
    +                                                         gint y_2,
    +                                                         gint x_3,
    +                                                         gint y_3);
    +void                clutter_path_add_close              (ClutterPath *path);
    +gboolean            clutter_path_add_string             (ClutterPath *path,
    +                                                         const gchar *str);
    +void                clutter_path_add_node               (ClutterPath *path,
    +                                                         const ClutterPathNode *node);
    +void                clutter_path_add_cairo_path         (ClutterPath *path,
    +                                                         const cairo_path_t *cpath);
     
    -guint               clutter_path_get_n_nodes            (ClutterPath *path);
    -void                clutter_path_get_node               (ClutterPath *path,
    -                                                         guint index_,
    -                                                         ClutterPathNode *node);
    -GSList *            clutter_path_get_nodes              (ClutterPath *path);
    -void                clutter_path_foreach                (ClutterPath *path,
    -                                                         ClutterPathCallback callback,
    -                                                         gpointer user_data);
    -void                clutter_path_insert_node            (ClutterPath *path,
    -                                                         gint index_,
    -                                                         const ClutterPathNode *node);
    -void                clutter_path_remove_node            (ClutterPath *path,
    -                                                         guint index_);
    -void                clutter_path_replace_node           (ClutterPath *path,
    -                                                         guint index_,
    -                                                         const ClutterPathNode *node);
    -gchar *             clutter_path_get_description        (ClutterPath *path);
    -gboolean            clutter_path_set_description        (ClutterPath *path,
    -                                                         const gchar *str);
    -void                clutter_path_to_cairo_path          (ClutterPath *path,
    -                                                         cairo_t *cr);
    -void                clutter_path_clear                  (ClutterPath *path);
    -guint               clutter_path_get_position           (ClutterPath *path,
    -                                                         gdouble progress,
    -                                                         ClutterKnot *position);
    -guint               clutter_path_get_length             (ClutterPath *path);
    +guint               clutter_path_get_n_nodes            (ClutterPath *path);
    +void                clutter_path_get_node               (ClutterPath *path,
    +                                                         guint index_,
    +                                                         ClutterPathNode *node);
    +GSList *            clutter_path_get_nodes              (ClutterPath *path);
    +void                clutter_path_foreach                (ClutterPath *path,
    +                                                         ClutterPathCallback callback,
    +                                                         gpointer user_data);
    +void                clutter_path_insert_node            (ClutterPath *path,
    +                                                         gint index_,
    +                                                         const ClutterPathNode *node);
    +void                clutter_path_remove_node            (ClutterPath *path,
    +                                                         guint index_);
    +void                clutter_path_replace_node           (ClutterPath *path,
    +                                                         guint index_,
    +                                                         const ClutterPathNode *node);
    +gchar *             clutter_path_get_description        (ClutterPath *path);
    +gboolean            clutter_path_set_description        (ClutterPath *path,
    +                                                         const gchar *str);
    +void                clutter_path_to_cairo_path          (ClutterPath *path,
    +                                                         cairo_t *cr);
    +void                clutter_path_clear                  (ClutterPath *path);
    +guint               clutter_path_get_position           (ClutterPath *path,
    +                                                         gdouble progress,
    +                                                         ClutterKnot *position);
    +guint               clutter_path_get_length             (ClutterPath *path);
     
                         ClutterPathNode;
    -ClutterPathNode *   clutter_path_node_copy              (const ClutterPathNode *node);
    -void                clutter_path_node_free              (ClutterPathNode *node);
    -gboolean            clutter_path_node_equal             (const ClutterPathNode *node_a,
    -                                                         const ClutterPathNode *node_b);
    +ClutterPathNode *   clutter_path_node_copy              (const ClutterPathNode *node);
    +void                clutter_path_node_free              (ClutterPathNode *node);
    +gboolean            clutter_path_node_equal             (const ClutterPathNode *node_a,
    +                                                         const ClutterPathNode *node_b);
     

    Object Hierarchy

    -  GObject
    -   +----GInitiallyUnowned
    +  GObject
    +   +----GInitiallyUnowned
              +----ClutterPath
     

    Properties

    -  "description"              gchar*                : Read / Write
    -  "length"                   guint                 : Read
    +  "description"              gchar*                : Read / Write
    +  "length"                   guint                 : Read
     
    @@ -190,7 +279,7 @@ -

    CLUTTER_PATH_MOVE_TO

    +

    CLUTTER_PATH_MOVE_TO

    Changes the position of the path to the given pair of coordinates. This is usually used as the first node of a path to @@ -200,13 +289,13 @@

    -

    CLUTTER_PATH_LINE_TO

    +

    CLUTTER_PATH_LINE_TO

    Creates a straight line from the previous point to the given point.

    -

    CLUTTER_PATH_CURVE_TO

    +

    CLUTTER_PATH_CURVE_TO

    Creates a bezier curve. The end of the last node is used as the first control point and the three subsequent coordinates given in @@ -214,10 +303,10 @@

    -

    CLUTTER_PATH_CLOSE

    +

    CLUTTER_PATH_CLOSE

    Creates a straight line from the last node to the last -CLUTTER_PATH_MOVE_TO node. This can be used to close a path so +CLUTTER_PATH_MOVE_TO node. This can be used to close a path so that it will appear as a loop when animated.

    @@ -227,8 +316,8 @@

    The first three types have the corresponding relative versions -CLUTTER_PATH_REL_MOVE_TO, CLUTTER_PATH_REL_LINE_TO and -CLUTTER_PATH_REL_CURVE_TO. These are exactly the same except the +CLUTTER_PATH_REL_MOVE_TO, CLUTTER_PATH_REL_LINE_TO and +CLUTTER_PATH_REL_CURVE_TO. These are exactly the same except the coordinates are given relative to the previous node instead of as direct screen positions.

    @@ -240,6 +329,8 @@

    ClutterPath is available since Clutter 1.0

    +

    +

    Details

    @@ -249,6 +340,8 @@

    The ClutterPath struct contains only private data and should be accessed with the functions below.

    +

    +

    Since 1.0


    @@ -259,16 +352,22 @@

    The ClutterPathClass struct contains only private data.

    +

    +

    Since 1.0


    ClutterPathCallback ()

    -
    void                (*ClutterPathCallback)              (const ClutterPathNode *node,
    -                                                         gpointer data);
    +
    void                (*ClutterPathCallback)              (const ClutterPathNode *node,
    +                                                         gpointer data);

    This function is passed to clutter_path_foreach() and will be called for each node contained in the path.

    +

    +

    @@ -302,47 +401,49 @@

    Types of nodes in a ClutterPath.

    +

    +

    - + - + - + - + - - + - - + - - + @@ -353,13 +454,15 @@

    clutter_path_new ()

    -
    ClutterPath *       clutter_path_new                    (void);
    +
    ClutterPath *       clutter_path_new                    (void);

    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.

    +

    +

    CLUTTER_PATH_MOVE_TO

    CLUTTER_PATH_MOVE_TO

    jump to the given position

    CLUTTER_PATH_LINE_TO

    CLUTTER_PATH_LINE_TO

    create a line from the last node to the given position

    CLUTTER_PATH_CURVE_TO

    CLUTTER_PATH_CURVE_TO

    bezier curve using the last position and three control points.

    CLUTTER_PATH_CLOSE

    CLUTTER_PATH_CLOSE

    create a line from the last node to the last - CLUTTER_PATH_MOVE_TO node. + CLUTTER_PATH_MOVE_TO node.

    CLUTTER_PATH_REL_MOVE_TO

    same as CLUTTER_PATH_MOVE_TO but with +

    CLUTTER_PATH_REL_MOVE_TO

    same as CLUTTER_PATH_MOVE_TO but with coordinates relative to the last node.

    CLUTTER_PATH_REL_LINE_TO

    same as CLUTTER_PATH_LINE_TO but with +

    CLUTTER_PATH_REL_LINE_TO

    same as CLUTTER_PATH_LINE_TO but with coordinates relative to the last node.

    CLUTTER_PATH_REL_CURVE_TO

    same as CLUTTER_PATH_CURVE_TO but with +

    CLUTTER_PATH_REL_CURVE_TO

    same as CLUTTER_PATH_CURVE_TO but with coordinates relative to the last node.
    @@ -374,7 +477,9 @@

    clutter_path_new_with_description ()

    -
    ClutterPath *       clutter_path_new_with_description   (const gchar *desc);
    +
    ClutterPath *       clutter_path_new_with_description   (const gchar *desc);

    Creates a new ClutterPath instance with the nodes described in desc. See clutter_path_add_string() for details of the format of @@ -383,6 +488,8 @@

    The object has a floating reference so if you add it to a ClutterBehaviourPath then you do not need to unref it.

    +

    +

    @@ -404,13 +511,19 @@

    clutter_path_add_move_to ()

    -
    void                clutter_path_add_move_to            (ClutterPath *path,
    -                                                         gint x,
    -                                                         gint y);
    +
    void                clutter_path_add_move_to            (ClutterPath *path,
    +                                                         gint x,
    +                                                         gint y);

    -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.

    +

    +

    @@ -436,12 +549,18 @@

    clutter_path_add_rel_move_to ()

    -
    void                clutter_path_add_rel_move_to        (ClutterPath *path,
    -                                                         gint x,
    -                                                         gint y);
    +
    void                clutter_path_add_rel_move_to        (ClutterPath *path,
    +                                                         gint x,
    +                                                         gint y);

    Same as clutter_path_add_move_to() except the coordinates are relative to the previous node.

    +

    +

    @@ -467,12 +586,18 @@

    clutter_path_add_line_to ()

    -
    void                clutter_path_add_line_to            (ClutterPath *path,
    -                                                         gint x,
    -                                                         gint y);
    +
    void                clutter_path_add_line_to            (ClutterPath *path,
    +                                                         gint x,
    +                                                         gint y);

    -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.

    +

    +

    @@ -498,12 +623,18 @@

    clutter_path_add_rel_line_to ()

    -
    void                clutter_path_add_rel_line_to        (ClutterPath *path,
    -                                                         gint x,
    -                                                         gint y);
    +
    void                clutter_path_add_rel_line_to        (ClutterPath *path,
    +                                                         gint x,
    +                                                         gint y);

    Same as clutter_path_add_line_to() except the coordinates are relative to the previous node.

    +

    +

    @@ -529,17 +660,31 @@

    clutter_path_add_curve_to ()

    -
    void                clutter_path_add_curve_to           (ClutterPath *path,
    -                                                         gint x_1,
    -                                                         gint y_1,
    -                                                         gint x_2,
    -                                                         gint y_2,
    -                                                         gint x_3,
    -                                                         gint y_3);
    +
    void                clutter_path_add_curve_to           (ClutterPath *path,
    +                                                         gint x_1,
    +                                                         gint y_1,
    +                                                         gint x_2,
    +                                                         gint y_2,
    +                                                         gint x_3,
    +                                                         gint y_3);

    -Adds a CLUTTER_PATH_CURVE_TO type node to the path. This causes +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.

    +

    +

    @@ -585,16 +730,30 @@

    clutter_path_add_rel_curve_to ()

    -
    void                clutter_path_add_rel_curve_to       (ClutterPath *path,
    -                                                         gint x_1,
    -                                                         gint y_1,
    -                                                         gint x_2,
    -                                                         gint y_2,
    -                                                         gint x_3,
    -                                                         gint y_3);
    +
    void                clutter_path_add_rel_curve_to       (ClutterPath *path,
    +                                                         gint x_1,
    +                                                         gint y_1,
    +                                                         gint x_2,
    +                                                         gint y_2,
    +                                                         gint x_3,
    +                                                         gint y_3);

    Same as clutter_path_add_curve_to() except the coordinates are relative to the previous node.

    +

    +

    @@ -640,11 +799,13 @@

    clutter_path_add_close ()

    -
    void                clutter_path_add_close              (ClutterPath *path);
    +
    void                clutter_path_add_close              (ClutterPath *path);

    -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.

    +

    +

    @@ -658,8 +819,12 @@

    clutter_path_add_string ()

    -
    gboolean            clutter_path_add_string             (ClutterPath *path,
    -                                                         const gchar *str);
    +
    gboolean            clutter_path_add_string             (ClutterPath *path,
    +                                                         const gchar *str);

    Adds new nodes to the end of the path as described in str. The format is a subset of the SVG path format. Each node is represented @@ -675,25 +840,25 @@

    @@ -716,8 +881,10 @@

    -If the path description isn't valid FALSE will be returned and no +If the path description isn't valid FALSE will be returned and no nodes will be added.

    +

    +

    M

    -Adds a CLUTTER_PATH_MOVE_TO node. Takes one pair of coordinates. +Adds a CLUTTER_PATH_MOVE_TO node. Takes one pair of coordinates.

    L

    -Adds a CLUTTER_PATH_LINE_TO node. Takes one pair of coordinates. +Adds a CLUTTER_PATH_LINE_TO node. Takes one pair of coordinates.

    C

    -Adds a CLUTTER_PATH_CURVE_TO node. Takes three pairs of coordinates. +Adds a CLUTTER_PATH_CURVE_TO node. Takes three pairs of coordinates.

    z

    -Adds a CLUTTER_PATH_CLOSE node. No coordinates are needed. +Adds a CLUTTER_PATH_CLOSE node. No coordinates are needed.

    @@ -733,7 +900,7 @@ - @@ -745,10 +912,12 @@

    clutter_path_add_node ()

    -
    void                clutter_path_add_node               (ClutterPath *path,
    -                                                         const ClutterPathNode *node);
    +
    void                clutter_path_add_node               (ClutterPath *path,
    +                                                         const ClutterPathNode *node);

    Adds node to the end of the path.

    +

    +

    Returns :

    TRUE is the path description was valid or FALSE + TRUE is the path description was valid or FALSE otherwise.
    @@ -769,10 +938,14 @@

    clutter_path_add_cairo_path ()

    -
    void                clutter_path_add_cairo_path         (ClutterPath *path,
    -                                                         const cairo_path_t *cpath);
    +
    void                clutter_path_add_cairo_path         (ClutterPath *path,
    +                                                         const cairo_path_t *cpath);

    Add the nodes of the Cairo path to the end of path.

    +

    +

    @@ -793,9 +966,13 @@

    clutter_path_get_n_nodes ()

    -
    guint               clutter_path_get_n_nodes            (ClutterPath *path);
    +
    guint               clutter_path_get_n_nodes            (ClutterPath *path);

    Retrieves the number of nodes in the path.

    +

    +

    @@ -817,11 +994,15 @@

    clutter_path_get_node ()

    -
    void                clutter_path_get_node               (ClutterPath *path,
    -                                                         guint index_,
    -                                                         ClutterPathNode *node);
    +
    void                clutter_path_get_node               (ClutterPath *path,
    +                                                         guint index_,
    +                                                         ClutterPathNode *node);

    Retrieves the node of the path indexed by index.

    +

    +

    @@ -847,13 +1028,21 @@

    clutter_path_get_nodes ()

    -
    GSList *            clutter_path_get_nodes              (ClutterPath *path);
    -

    -Returns a GSList of ClutterPathNodes. The list should be -freed with g_slist_free(). The nodes are owned by the path and +

    GSList *            clutter_path_get_nodes              (ClutterPath *path);
    +

    +Returns a GSList of ClutterPathNodes. 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.

    +

    +

    @@ -864,7 +1053,7 @@ - +

    Returns :

    a list of nodes in the path.. transfer container. element-type ClutterPathNode. a list of nodes in the path.. transfer container. element-type ClutterPathNode.
    @@ -873,11 +1062,15 @@

    clutter_path_foreach ()

    -
    void                clutter_path_foreach                (ClutterPath *path,
    -                                                         ClutterPathCallback callback,
    -                                                         gpointer user_data);
    +
    void                clutter_path_foreach                (ClutterPath *path,
    +                                                         ClutterPathCallback callback,
    +                                                         gpointer user_data);

    Calls a function for each node of the path.

    +

    +

    @@ -903,12 +1096,16 @@

    clutter_path_insert_node ()

    -
    void                clutter_path_insert_node            (ClutterPath *path,
    -                                                         gint index_,
    -                                                         const ClutterPathNode *node);
    +
    void                clutter_path_insert_node            (ClutterPath *path,
    +                                                         gint index_,
    +                                                         const ClutterPathNode *node);

    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.

    +

    +

    @@ -934,10 +1131,14 @@

    clutter_path_remove_node ()

    -
    void                clutter_path_remove_node            (ClutterPath *path,
    -                                                         guint index_);
    +
    void                clutter_path_remove_node            (ClutterPath *path,
    +                                                         guint index_);

    Removes the node at the given offset from the path.

    +

    +

    @@ -958,11 +1159,15 @@

    clutter_path_replace_node ()

    -
    void                clutter_path_replace_node           (ClutterPath *path,
    -                                                         guint index_,
    -                                                         const ClutterPathNode *node);
    +
    void                clutter_path_replace_node           (ClutterPath *path,
    +                                                         guint index_,
    +                                                         const ClutterPathNode *node);

    Replaces the node at offset index_ with node.

    +

    +

    @@ -988,10 +1193,14 @@

    clutter_path_get_description ()

    -
    gchar *             clutter_path_get_description        (ClutterPath *path);
    +
    gchar *             clutter_path_get_description        (ClutterPath *path);

    Returns a newly allocated string describing the path in the same format as used by clutter_path_add_string().

    +

    +

    @@ -1002,7 +1211,9 @@ - @@ -1013,15 +1224,21 @@

    clutter_path_set_description ()

    -
    gboolean            clutter_path_set_description        (ClutterPath *path,
    -                                                         const gchar *str);
    +
    gboolean            clutter_path_set_description        (ClutterPath *path,
    +                                                         const gchar *str);

    Replaces all of the nodes in the path with nodes described by str. See clutter_path_add_string() for details of the format.

    -If the string is invalid then FALSE is returned and the path is +If the string is invalid then FALSE is returned and the path is unaltered.

    +

    +

    Returns :

    a string description of the path. Free with g_free(). + a string description of the path. Free with g_free().
    @@ -1037,7 +1254,7 @@ - @@ -1048,10 +1265,14 @@

    clutter_path_to_cairo_path ()

    -
    void                clutter_path_to_cairo_path          (ClutterPath *path,
    -                                                         cairo_t *cr);
    +
    void                clutter_path_to_cairo_path          (ClutterPath *path,
    +                                                         cairo_t *cr);

    Add the nodes of the ClutterPath to the path in the Cairo context.

    +

    +

    Returns :

    TRUE is the path was valid, FALSE otherwise. + TRUE is the path was valid, FALSE otherwise.
    @@ -1072,9 +1293,11 @@

    clutter_path_clear ()

    -
    void                clutter_path_clear                  (ClutterPath *path);
    +
    void                clutter_path_clear                  (ClutterPath *path);

    Removes all nodes from the path.

    +

    +

    @@ -1088,13 +1311,19 @@

    clutter_path_get_position ()

    -
    guint               clutter_path_get_position           (ClutterPath *path,
    -                                                         gdouble progress,
    -                                                         ClutterKnot *position);
    +
    guint               clutter_path_get_position           (ClutterPath *path,
    +                                                         gdouble progress,
    +                                                         ClutterKnot *position);

    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.

    +

    +

    @@ -1126,9 +1355,13 @@

    clutter_path_get_length ()

    -
    guint               clutter_path_get_length             (ClutterPath *path);
    +
    guint               clutter_path_get_length             (ClutterPath *path);

    Retrieves an approximation of the total length of the path.

    +

    +

    @@ -1161,19 +1394,21 @@

    Some of the coordinates in points may be unused for some node -types. CLUTTER_PATH_MOVE_TO and CLUTTER_PATH_LINE_TO use only one -pair of coordinates, CLUTTER_PATH_CURVE_TO uses all three and -CLUTTER_PATH_CLOSE uses none.

    +types. CLUTTER_PATH_MOVE_TO and CLUTTER_PATH_LINE_TO use only one +pair of coordinates, CLUTTER_PATH_CURVE_TO uses all three and +CLUTTER_PATH_CLOSE uses none.

    +

    +

    - + - + @@ -1184,9 +1419,11 @@

    clutter_path_node_copy ()

    -
    ClutterPathNode *   clutter_path_node_copy              (const ClutterPathNode *node);
    +
    ClutterPathNode *   clutter_path_node_copy              (const ClutterPathNode *node);

    Makes an allocated copy of a node.

    +

    +

    ClutterPathNodeType type;

    ClutterPathNodeType type;

    the node's type

    ClutterKnot points[3];

    ClutterKnot points[3];

    the coordinates of the node
    @@ -1208,9 +1445,11 @@

    clutter_path_node_free ()

    -
    void                clutter_path_node_free              (ClutterPathNode *node);
    +
    void                clutter_path_node_free              (ClutterPathNode *node);

    Frees the memory of an allocated node.

    +

    +

    @@ -1224,11 +1463,15 @@

    clutter_path_node_equal ()

    -
    gboolean            clutter_path_node_equal             (const ClutterPathNode *node_a,
    -                                                         const ClutterPathNode *node_b);
    +
    gboolean            clutter_path_node_equal             (const ClutterPathNode *node_a,
    +                                                         const ClutterPathNode *node_b);

    Compares two nodes and checks if they are the same type with the same coordinates.

    +

    +

    @@ -1244,7 +1487,7 @@ - @@ -1257,14 +1500,18 @@

    Property Details

    The "description" property

    -
      "description"              gchar*                : Read / Write
    +
      "description"              gchar*                : Read / Write

    SVG-style description of the path.

    Default value: ""


    The "length" property

    -
      "length"                   guint                 : Read
    +
      "length"                   guint                 : Read

    An approximation of the total length of the path.

    Default value: 0

    @@ -1272,6 +1519,6 @@ + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/clutter-Versioning-Macros.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/clutter-Versioning-Macros.html @@ -8,7 +8,7 @@ - + @@ -62,8 +62,8 @@

    Returns :

    TRUE if the nodes are the same. + TRUE if the nodes are the same.
    Top -  |  - Description +  |  + Description
    @@ -77,25 +77,34 @@

    Synopsis

    -
    #define             CLUTTER_MAJOR_VERSION
    -#define             CLUTTER_MINOR_VERSION
    -#define             CLUTTER_MICRO_VERSION
    -#define             CLUTTER_VERSION
    -#define             CLUTTER_VERSION_S
    -#define             CLUTTER_VERSION_HEX
    +
    +#define             CLUTTER_MAJOR_VERSION
    +#define             CLUTTER_MINOR_VERSION
    +#define             CLUTTER_MICRO_VERSION
    +#define             CLUTTER_VERSION
    +#define             CLUTTER_VERSION_S
    +#define             CLUTTER_VERSION_HEX
     
    -#define             CLUTTER_CHECK_VERSION               (major,minor,micro)
    +#define             CLUTTER_CHECK_VERSION               (major,minor,micro)
     
    -#define             CLUTTER_FLAVOUR
    -#define             CLUTTER_COGL
    -#define             CLUTTER_NO_FPU
    +#define             CLUTTER_FLAVOUR
    +#define             CLUTTER_COGL
    +#define             CLUTTER_NO_FPU
     
     extern              const guint clutter_major_version;
     extern              const guint clutter_minor_version;
     extern              const guint clutter_micro_version;
    -gboolean            clutter_check_version               (guint major,
    -                                                         guint minor,
    -                                                         guint micro);
    +gboolean            clutter_check_version               (guint major,
    +                                                         guint minor,
    +                                                         guint micro);
     
    @@ -103,63 +112,79 @@

    Clutter offers a set of macros for checking the version of the library an application was linked to.

    +

    +

    Details

    -

    CLUTTER_MAJOR_VERSION

    +

    CLUTTER_MAJOR_VERSION

    #define CLUTTER_MAJOR_VERSION   (1)
     

    -The major version of the Clutter library (1, if CLUTTER_VERSION is 1.2.3)

    +The major version of the Clutter library (1, if CLUTTER_VERSION is 1.2.3)

    +

    +


    -

    CLUTTER_MINOR_VERSION

    +

    CLUTTER_MINOR_VERSION

    #define CLUTTER_MINOR_VERSION   (2)
     

    -The minor version of the Clutter library (2, if CLUTTER_VERSION is 1.2.3)

    +The minor version of the Clutter library (2, if CLUTTER_VERSION is 1.2.3)

    +

    +


    -

    CLUTTER_MICRO_VERSION

    +

    CLUTTER_MICRO_VERSION

    #define CLUTTER_MICRO_VERSION   (4)
     

    -The micro version of the Clutter library (3, if CLUTTER_VERSION is 1.2.3)

    +The micro version of the Clutter library (3, if CLUTTER_VERSION is 1.2.3)

    +

    +


    -

    CLUTTER_VERSION

    +

    CLUTTER_VERSION

    #define CLUTTER_VERSION         1.2.4
     

    The full version of the Clutter library, like 1.2.3

    +

    +


    -

    CLUTTER_VERSION_S

    +

    CLUTTER_VERSION_S

    #define CLUTTER_VERSION_S       "1.2.4"
     

    The full version of the Clutter library, in string form (suited for string concatenation)

    +

    +


    -

    CLUTTER_VERSION_HEX

    +

    CLUTTER_VERSION_HEX

    #define             CLUTTER_VERSION_HEX

    Numerically encoded version of the Clutter library, like 0x010203

    +

    +


    -

    CLUTTER_CHECK_VERSION()

    +

    CLUTTER_CHECK_VERSION()

    #define             CLUTTER_CHECK_VERSION(major,minor,micro)

    -Evaluates to TRUE if the version of the Clutter library is greater +Evaluates to TRUE if the version of the Clutter library is greater than major, minor and micro

    +

    +

    @@ -183,26 +208,30 @@
    -

    CLUTTER_FLAVOUR

    +

    CLUTTER_FLAVOUR

    #define CLUTTER_FLAVOUR         "glx"
     

    GL Windowing system used

    +

    +

    Since 0.4


    -

    CLUTTER_COGL

    +

    CLUTTER_COGL

    #define CLUTTER_COGL            "gl"
     

    Cogl (internal GL abstraction utility library) backend. Can be "gl" or "gles" currently

    +

    +

    Since 0.4


    -

    CLUTTER_NO_FPU

    +

    CLUTTER_NO_FPU

    #define CLUTTER_NO_FPU          CLUTTER_NO_FPU_MACRO_WAS_REMOVED
     

    @@ -211,6 +240,8 @@

    Deprecated: 0.6: This macro is no longer defined (identical code is used regardless the presence of FPU).

    +

    +


    @@ -225,7 +256,9 @@ This value can be used for run-time version checks

    -For a compile-time check, use CLUTTER_MAJOR_VERSION

    +For a compile-time check, use CLUTTER_MAJOR_VERSION

    +

    +

    Since 1.2


    @@ -241,7 +274,9 @@ This value can be used for run-time version checks

    -For a compile-time check, use CLUTTER_MINOR_VERSION

    +For a compile-time check, use CLUTTER_MINOR_VERSION

    +

    +

    Since 1.2


    @@ -257,22 +292,34 @@ This value can be used for run-time version checks

    -For a compile-time check, use CLUTTER_MICRO_VERSION

    +For a compile-time check, use CLUTTER_MICRO_VERSION

    +

    +

    Since 1.2


    clutter_check_version ()

    -
    gboolean            clutter_check_version               (guint major,
    -                                                         guint minor,
    -                                                         guint micro);
    +
    gboolean            clutter_check_version               (guint major,
    +                                                         guint minor,
    +                                                         guint micro);

    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 +This is the run-time equivalent of the compile-time CLUTTER_CHECK_VERSION pre-processor macro

    +

    +

    @@ -293,8 +340,8 @@ - @@ -306,6 +353,6 @@ + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ch01.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ch01.html @@ -8,7 +8,7 @@ - + @@ -61,7 +61,7 @@

    Returns :

    TRUE if the version of the Clutter library is - greater than (major, minor, micro), and FALSE otherwise + TRUE if the version of the Clutter library is + greater than (major, minor, micro), and FALSE otherwise

    -Abstract classes and interfaces

    +Abstract classes and interfaces
    ClutterActor — Base abstract class for all visual stage actors. @@ -85,6 +85,6 @@
    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ix07.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ix07.html @@ -8,7 +8,7 @@ - + @@ -52,50 +52,20 @@ - - + - - - +

    -Index of new symbols in 1.0

    -

    A

    +Index of new symbols in 1.0
    +
    + + + + +
    +

    F

    +
    ClutterFontFlags
    -

    G

    +
    +
    + + + + + + + + + + +
    +
    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ClutterModelIter.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ClutterModelIter.html @@ -8,7 +8,7 @@ - + @@ -62,12 +62,12 @@ Top -  |  - Description -  |  - Object Hierarchy -  |  - Properties +  |  + Description +  |  + Object Hierarchy +  |  + Properties
    @@ -81,46 +81,65 @@

    Synopsis

    -
                        ClutterModelIter;
    +
    +                    ClutterModelIter;
                         ClutterModelIterClass;
    -ClutterModelIter *  clutter_model_iter_copy             (ClutterModelIter *iter);
    +ClutterModelIter *  clutter_model_iter_copy             (ClutterModelIter *iter);
     
    -void                clutter_model_iter_get              (ClutterModelIter *iter,
    +void                clutter_model_iter_get              (ClutterModelIter *iter,
                                                              ...);
    -void                clutter_model_iter_get_valist       (ClutterModelIter *iter,
    -                                                         va_list args);
    -void                clutter_model_iter_get_value        (ClutterModelIter *iter,
    -                                                         guint column,
    -                                                         GValue *value);
    -void                clutter_model_iter_set              (ClutterModelIter *iter,
    +void                clutter_model_iter_get_valist       (ClutterModelIter *iter,
    +                                                         va_list args);
    +void                clutter_model_iter_get_value        (ClutterModelIter *iter,
    +                                                         guint column,
    +                                                         GValue *value);
    +void                clutter_model_iter_set              (ClutterModelIter *iter,
                                                              ...);
    -void                clutter_model_iter_set_valist       (ClutterModelIter *iter,
    -                                                         va_list args);
    -void                clutter_model_iter_set_value        (ClutterModelIter *iter,
    -                                                         guint column,
    -                                                         const GValue *value);
    -
    -gboolean            clutter_model_iter_is_first         (ClutterModelIter *iter);
    -gboolean            clutter_model_iter_is_last          (ClutterModelIter *iter);
    -ClutterModelIter *  clutter_model_iter_next             (ClutterModelIter *iter);
    -ClutterModelIter *  clutter_model_iter_prev             (ClutterModelIter *iter);
    -
    -ClutterModel *      clutter_model_iter_get_model        (ClutterModelIter *iter);
    -guint               clutter_model_iter_get_row          (ClutterModelIter *iter);
    +void                clutter_model_iter_set_valist       (ClutterModelIter *iter,
    +                                                         va_list args);
    +void                clutter_model_iter_set_value        (ClutterModelIter *iter,
    +                                                         guint column,
    +                                                         const GValue *value);
    +
    +gboolean            clutter_model_iter_is_first         (ClutterModelIter *iter);
    +gboolean            clutter_model_iter_is_last          (ClutterModelIter *iter);
    +ClutterModelIter *  clutter_model_iter_next             (ClutterModelIter *iter);
    +ClutterModelIter *  clutter_model_iter_prev             (ClutterModelIter *iter);
    +
    +ClutterModel *      clutter_model_iter_get_model        (ClutterModelIter *iter);
    +guint               clutter_model_iter_get_row          (ClutterModelIter *iter);
     

    Object Hierarchy

    -  GObject
    +  GObject
        +----ClutterModelIter
     

    Properties

    -  "model"                    ClutterModel*         : Read / Write
    -  "row"                      guint                 : Read / Write
    +  "model"                    ClutterModel*         : Read / Write
    +  "row"                      guint                 : Read / Write
     
    @@ -144,6 +163,8 @@

    ClutterModelIter is available since Clutter 0.6

    +

    +

    Details

    @@ -154,6 +175,8 @@ Base class for list models iters. The ClutterModelIter structure contains only private data and should be manipulated using the provided API.

    +

    +

    Since 0.6


    @@ -182,59 +205,61 @@

    Class for ClutterModelIter instances.

    +

    +

    - + - + - + - + - + - + - + - + - + @@ -245,9 +270,11 @@

    clutter_model_iter_copy ()

    -
    ClutterModelIter *  clutter_model_iter_copy             (ClutterModelIter *iter);
    +
    ClutterModelIter *  clutter_model_iter_copy             (ClutterModelIter *iter);

    Copies the passed iterator.

    +

    +

    get_value ()

    get_value ()

    Virtual function for retrieving the value at the given column of the row pointed by the iterator

    set_value ()

    set_value ()

    Virtual function for setting the value at the given column of the row pointer by the iterator

    is_first ()

    is_first ()

    Virtual function for knowing whether the iterator points at the first row in the model

    is_last ()

    is_last ()

    Virtual function for knowing whether the iterator points at the last row in the model

    next ()

    next ()

    Virtual function for moving the iterator to the following row in the model

    prev ()

    prev ()

    Virtual function for moving the iterator toe the previous row in the model

    get_model ()

    get_model ()

    Virtual function for getting the model to which the iterator belongs to

    get_row ()

    get_row ()

    Virtual function for getting the row to which the iterator points

    copy ()

    copy ()

    Virtual function for copying a ClutterModelIter.
    @@ -258,7 +285,7 @@ - @@ -269,7 +296,7 @@

    clutter_model_iter_get ()

    -
    void                clutter_model_iter_get              (ClutterModelIter *iter,
    +
    void                clutter_model_iter_get              (ClutterModelIter *iter,
                                                              ...);

    Gets the value of one or more cells in the row referenced by iter. The @@ -278,7 +305,7 @@ list is terminated by a -1.

    -For example, to get a value from column 0 with type G_TYPE_STRING use: +For example, to get a value from column 0 with type G_TYPE_STRING use:

       clutter_model_iter_get (iter, 0, &place_string_here, -1);
    @@ -288,6 +315,8 @@
     

    where place_string_here is a gchar* to be filled with the string. If appropriate, the returned values have to be freed or unreferenced.

    +

    +

    Returns :

    a copy of the iterator, or NULL + a copy of the iterator, or NULL
    @@ -308,11 +337,13 @@

    clutter_model_iter_get_valist ()

    -
    void                clutter_model_iter_get_valist       (ClutterModelIter *iter,
    -                                                         va_list args);
    +
    void                clutter_model_iter_get_valist       (ClutterModelIter *iter,
    +                                                         va_list args);

    See clutter_model_iter_get(). This version takes a va_list for language bindings.

    +

    +

    @@ -333,12 +364,20 @@

    clutter_model_iter_get_value ()

    -
    void                clutter_model_iter_get_value        (ClutterModelIter *iter,
    -                                                         guint column,
    -                                                         GValue *value);
    +
    void                clutter_model_iter_get_value        (ClutterModelIter *iter,
    +                                                         guint column,
    +                                                         GValue *value);

    Sets an initializes value to that at column. When done with value, -g_value_unset() needs to be called to free any allocated memory.

    +g_value_unset() needs to be called to free any allocated memory.

    +

    +

    @@ -354,7 +393,9 @@ - @@ -364,7 +405,7 @@

    clutter_model_iter_set ()

    -
    void                clutter_model_iter_set              (ClutterModelIter *iter,
    +
    void                clutter_model_iter_set              (ClutterModelIter *iter,
                                                              ...);

    Sets the value of one or more cells in the row referenced by iter. The @@ -373,11 +414,13 @@ -1.

    -For example, to set column 0 with type G_TYPE_STRING, use: +For example, to set column 0 with type G_TYPE_STRING, use:

       clutter_model_iter_set (iter, 0, "foo", -1);
     
    +

    +

    value :

    an empty GValue to set + an empty GValue to set
    @@ -398,11 +441,13 @@

    clutter_model_iter_set_valist ()

    -
    void                clutter_model_iter_set_valist       (ClutterModelIter *iter,
    -                                                         va_list args);
    +
    void                clutter_model_iter_set_valist       (ClutterModelIter *iter,
    +                                                         va_list args);

    See clutter_model_iter_set(); this version takes a va_list for language bindings.

    +

    +

    @@ -423,12 +468,18 @@

    clutter_model_iter_set_value ()

    -
    void                clutter_model_iter_set_value        (ClutterModelIter *iter,
    -                                                         guint column,
    -                                                         const GValue *value);
    +
    void                clutter_model_iter_set_value        (ClutterModelIter *iter,
    +                                                         guint column,
    +                                                         const GValue *value);

    Sets the data in the cell specified by iter and column. The type of value must be convertable to the type of the column.

    +

    +

    @@ -454,10 +505,14 @@

    clutter_model_iter_is_first ()

    -
    gboolean            clutter_model_iter_is_first         (ClutterModelIter *iter);
    +
    gboolean            clutter_model_iter_is_first         (ClutterModelIter *iter);

    Gets whether the current iterator is at the beginning of the model to which it belongs.

    +

    +

    @@ -468,7 +523,7 @@ - @@ -479,10 +534,14 @@

    clutter_model_iter_is_last ()

    -
    gboolean            clutter_model_iter_is_last          (ClutterModelIter *iter);
    +
    gboolean            clutter_model_iter_is_last          (ClutterModelIter *iter);

    Gets whether the iterator is at the end of the model to which it belongs.

    +

    +

    Returns :

    TRUE if iter is the first iter in the filtered model + TRUE if iter is the first iter in the filtered model
    @@ -493,7 +552,7 @@ - @@ -504,11 +563,13 @@

    clutter_model_iter_next ()

    -
    ClutterModelIter *  clutter_model_iter_next             (ClutterModelIter *iter);
    +
    ClutterModelIter *  clutter_model_iter_next             (ClutterModelIter *iter);

    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.

    +

    +

    Returns :

    TRUE if iter is the last iter in the filtered model. + TRUE if iter is the last iter in the filtered model.
    @@ -519,7 +580,7 @@ - +

    Returns :

    transfer none. transfer none. transfer none. transfer none.
    @@ -528,11 +589,13 @@

    clutter_model_iter_prev ()

    -
    ClutterModelIter *  clutter_model_iter_prev             (ClutterModelIter *iter);
    +
    ClutterModelIter *  clutter_model_iter_prev             (ClutterModelIter *iter);

    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.

    +

    +

    @@ -543,7 +606,7 @@ - +

    Returns :

    transfer none. transfer none. transfer none. transfer none.
    @@ -552,9 +615,11 @@

    clutter_model_iter_get_model ()

    -
    ClutterModel *      clutter_model_iter_get_model        (ClutterModelIter *iter);
    +
    ClutterModel *      clutter_model_iter_get_model        (ClutterModelIter *iter);

    Retrieves a pointer to the ClutterModel that this iter is part of.

    +

    +

    @@ -565,7 +630,7 @@ - +

    Returns :

    a pointer to a ClutterModel.. transfer none. a pointer to a ClutterModel.. transfer none.
    @@ -574,9 +639,13 @@

    clutter_model_iter_get_row ()

    -
    guint               clutter_model_iter_get_row          (ClutterModelIter *iter);
    +
    guint               clutter_model_iter_get_row          (ClutterModelIter *iter);

    Retrieves the position of the row that the iter points to.

    +

    +

    @@ -600,24 +669,30 @@

    Property Details

    The "model" property

    -
      "model"                    ClutterModel*         : Read / Write
    +
      "model"                    ClutterModel*         : Read / Write

    A reference to the ClutterModel that this iter belongs to.

    -

    Since 0.6

    +

    +

    +

    Since 0.6


    The "row" property

    -
      "row"                      guint                 : Read / Write
    +
      "row"                      guint                 : Read / Write

    The row number to which this iter points to.

    +

    +

    Default value: 0

    -

    Since 0.6

    +

    Since 0.6

    + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ClutterBehaviour.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ClutterBehaviour.html @@ -8,7 +8,7 @@ - + @@ -62,16 +62,16 @@
    Top -  |  - Description -  |  - Object Hierarchy -  |  - Implemented Interfaces -  |  - Properties -  |  - Signals +  |  + Description +  |  + Object Hierarchy +  |  + Implemented Interfaces +  |  + Properties +  |  + Signals
    @@ -85,34 +85,49 @@

    Synopsis

    -
                        ClutterBehaviour;
    +
    +                    ClutterBehaviour;
                         ClutterBehaviourClass;
    -void                clutter_behaviour_apply             (ClutterBehaviour *behave,
    -                                                         ClutterActor *actor);
    -void                clutter_behaviour_remove            (ClutterBehaviour *behave,
    -                                                         ClutterActor *actor);
    -void                clutter_behaviour_remove_all        (ClutterBehaviour *behave);
    -gboolean            clutter_behaviour_is_applied        (ClutterBehaviour *behave,
    -                                                         ClutterActor *actor);
    -void                (*ClutterBehaviourForeachFunc)      (ClutterBehaviour *behaviour,
    -                                                         ClutterActor *actor,
    -                                                         gpointer data);
    -void                clutter_behaviour_actors_foreach    (ClutterBehaviour *behave,
    -                                                         ClutterBehaviourForeachFunc func,
    -                                                         gpointer data);
    -GSList *            clutter_behaviour_get_actors        (ClutterBehaviour *behave);
    -gint                clutter_behaviour_get_n_actors      (ClutterBehaviour *behave);
    -ClutterActor *      clutter_behaviour_get_nth_actor     (ClutterBehaviour *behave,
    -                                                         gint index_);
    -ClutterAlpha *      clutter_behaviour_get_alpha         (ClutterBehaviour *behave);
    -void                clutter_behaviour_set_alpha         (ClutterBehaviour *behave,
    -                                                         ClutterAlpha *alpha);
    +void                clutter_behaviour_apply             (ClutterBehaviour *behave,
    +                                                         ClutterActor *actor);
    +void                clutter_behaviour_remove            (ClutterBehaviour *behave,
    +                                                         ClutterActor *actor);
    +void                clutter_behaviour_remove_all        (ClutterBehaviour *behave);
    +gboolean            clutter_behaviour_is_applied        (ClutterBehaviour *behave,
    +                                                         ClutterActor *actor);
    +void                (*ClutterBehaviourForeachFunc)      (ClutterBehaviour *behaviour,
    +                                                         ClutterActor *actor,
    +                                                         gpointer data);
    +void                clutter_behaviour_actors_foreach    (ClutterBehaviour *behave,
    +                                                         ClutterBehaviourForeachFunc func,
    +                                                         gpointer data);
    +GSList *            clutter_behaviour_get_actors        (ClutterBehaviour *behave);
    +gint                clutter_behaviour_get_n_actors      (ClutterBehaviour *behave);
    +ClutterActor *      clutter_behaviour_get_nth_actor     (ClutterBehaviour *behave,
    +                                                         gint index_);
    +ClutterAlpha *      clutter_behaviour_get_alpha         (ClutterBehaviour *behave);
    +void                clutter_behaviour_set_alpha         (ClutterBehaviour *behave,
    +                                                         ClutterAlpha *alpha);
     

    Object Hierarchy

    -  GObject
    +  GObject
        +----ClutterBehaviour
              +----ClutterBehaviourDepth
              +----ClutterBehaviourEllipse
    @@ -131,7 +146,7 @@
     

    Properties

    -  "alpha"                    ClutterAlpha*         : Read / Write
    +  "alpha"                    ClutterAlpha*         : Read / Write
     
    @@ -190,6 +205,8 @@

    ClutterBehaviour is available since Clutter 0.2

    +

    +

    Details

    @@ -199,6 +216,8 @@

    ClutterBehaviour contains only private data and should be accessed with the functions below.

    +

    +

    Since 0.2


    @@ -218,11 +237,13 @@

    Base class for behaviours.

    +

    +

    - + - + - + @@ -246,11 +267,13 @@

    clutter_behaviour_apply ()

    -
    void                clutter_behaviour_apply             (ClutterBehaviour *behave,
    -                                                         ClutterActor *actor);
    +
    void                clutter_behaviour_apply             (ClutterBehaviour *behave,
    +                                                         ClutterActor *actor);

    Applies behave to actor. This function adds a reference on the actor.

    +

    +

    alpha_notify ()

    alpha_notify ()

    virtual function, called each time the ClutterAlpha computes a new alpha value; the actors to which the behaviour applies should be changed in this function. Every subclass of ClutterBehaviour @@ -230,12 +251,12 @@

    applied ()

    applied ()

    signal class handler for the ClutterBehaviour::applied signal

    removed ()

    removed ()

    signal class handler for the ClutterBehaviour::removed signal
    @@ -271,11 +294,13 @@

    clutter_behaviour_remove ()

    -
    void                clutter_behaviour_remove            (ClutterBehaviour *behave,
    -                                                         ClutterActor *actor);
    +
    void                clutter_behaviour_remove            (ClutterBehaviour *behave,
    +                                                         ClutterActor *actor);

    Removes actor from the list of ClutterActors to which behave applies. This function removes a reference on the actor.

    +

    +

    @@ -296,9 +321,11 @@

    clutter_behaviour_remove_all ()

    -
    void                clutter_behaviour_remove_all        (ClutterBehaviour *behave);
    +
    void                clutter_behaviour_remove_all        (ClutterBehaviour *behave);

    Removes every actor from the list that behave holds.

    +

    +

    @@ -312,10 +339,14 @@

    clutter_behaviour_is_applied ()

    -
    gboolean            clutter_behaviour_is_applied        (ClutterBehaviour *behave,
    -                                                         ClutterActor *actor);
    +
    gboolean            clutter_behaviour_is_applied        (ClutterBehaviour *behave,
    +                                                         ClutterActor *actor);

    Check if behave applied to actor.

    +

    +

    @@ -342,12 +373,16 @@

    ClutterBehaviourForeachFunc ()

    -
    void                (*ClutterBehaviourForeachFunc)      (ClutterBehaviour *behaviour,
    -                                                         ClutterActor *actor,
    -                                                         gpointer data);
    +
    void                (*ClutterBehaviourForeachFunc)      (ClutterBehaviour *behaviour,
    +                                                         ClutterActor *actor,
    +                                                         gpointer data);

    This function is passed to clutter_behaviour_foreach_actor() and will be called for each actor driven by behaviour.

    +

    +

    @@ -373,11 +408,15 @@

    clutter_behaviour_actors_foreach ()

    -
    void                clutter_behaviour_actors_foreach    (ClutterBehaviour *behave,
    -                                                         ClutterBehaviourForeachFunc func,
    -                                                         gpointer data);
    +
    void                clutter_behaviour_actors_foreach    (ClutterBehaviour *behave,
    +                                                         ClutterBehaviourForeachFunc func,
    +                                                         gpointer data);

    Calls func for every actor driven by behave.

    +

    +

    @@ -393,7 +432,7 @@ - @@ -403,11 +442,15 @@

    clutter_behaviour_get_actors ()

    -
    GSList *            clutter_behaviour_get_actors        (ClutterBehaviour *behave);
    +
    GSList *            clutter_behaviour_get_actors        (ClutterBehaviour *behave);

    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.

    +

    +

    data :

    optional data to be passed to the function, or NULL + optional data to be passed to the function, or NULL
    @@ -418,7 +461,7 @@ - +

    Returns :

    transfer container) (element-type ClutterActor. transfer container. element-type ClutterActor. transfer container) (element-type ClutterActor. transfer container. element-type ClutterActor.
    @@ -427,9 +470,13 @@

    clutter_behaviour_get_n_actors ()

    -
    gint                clutter_behaviour_get_n_actors      (ClutterBehaviour *behave);
    +
    gint                clutter_behaviour_get_n_actors      (ClutterBehaviour *behave);

    Gets the number of actors this behaviour is applied too.

    +

    +

    @@ -451,10 +498,14 @@

    clutter_behaviour_get_nth_actor ()

    -
    ClutterActor *      clutter_behaviour_get_nth_actor     (ClutterBehaviour *behave,
    -                                                         gint index_);
    +
    ClutterActor *      clutter_behaviour_get_nth_actor     (ClutterBehaviour *behave,
    +                                                         gint index_);

    Gets an actor the behaviour was applied to referenced by index num.

    +

    +

    @@ -470,7 +521,7 @@ - +

    Returns :

    A Clutter actor or NULL if index_ is invalid.. transfer none. A Clutter actor or NULL if index_ is invalid.. transfer none.
    @@ -479,9 +530,11 @@

    clutter_behaviour_get_alpha ()

    -
    ClutterAlpha *      clutter_behaviour_get_alpha         (ClutterBehaviour *behave);
    +
    ClutterAlpha *      clutter_behaviour_get_alpha         (ClutterBehaviour *behave);

    Retrieves the ClutterAlpha object bound to behave.

    +

    +

    @@ -492,7 +545,7 @@ - +

    Returns :

    transfer none. transfer none. transfer none. transfer none.
    @@ -501,8 +554,8 @@

    clutter_behaviour_set_alpha ()

    -
    void                clutter_behaviour_set_alpha         (ClutterBehaviour *behave,
    -                                                         ClutterAlpha *alpha);
    +
    void                clutter_behaviour_set_alpha         (ClutterBehaviour *behave,
    +                                                         ClutterAlpha *alpha);

    Binds alpha to a ClutterBehaviour. The ClutterAlpha object is what makes a behaviour work: for each tick of the timeline @@ -512,8 +565,10 @@ actors to which the behaviour applies.

    -If alpha is not NULL, the ClutterBehaviour will take ownership +If alpha is not NULL, the ClutterBehaviour will take ownership of the ClutterAlpha instance.

    +

    +

    @@ -524,7 +579,7 @@ - @@ -536,25 +591,31 @@

    Property Details

    The "alpha" property

    -
      "alpha"                    ClutterAlpha*         : Read / Write
    +
      "alpha"                    ClutterAlpha*         : Read / Write

    The ClutterAlpha object used to drive this behaviour. A ClutterAlpha object binds a ClutterTimeline and a function which computes a value (the "alpha") depending on the time. Each time the alpha value changes the alpha-notify virtual function is called.

    -

    Since 0.2

    +

    +

    +

    Since 0.2

    Signal Details

    The "applied" signal

    -
    void                user_function                      (ClutterBehaviour *behaviour,
    -                                                        ClutterActor     *actor,
    -                                                        gpointer          user_data)      : Run First
    +
    void                user_function                      (ClutterBehaviour *behaviour,
    +                                                        ClutterActor     *actor,
    +                                                        gpointer          user_data)      : Run First

    The ::apply signal is emitted each time the behaviour is applied to an actor.

    +

    +

    alpha :

    a ClutterAlpha or NULL to unset a previously set alpha + a ClutterAlpha or NULL to unset a previously set alpha
    @@ -574,17 +635,21 @@
    -

    Since 0.4

    +

    Since 0.4


    The "removed" signal

    -
    void                user_function                      (ClutterBehaviour *behaviour,
    -                                                        ClutterActor     *actor,
    -                                                        gpointer          user_data)      : Run First
    +
    void                user_function                      (ClutterBehaviour *behaviour,
    +                                                        ClutterActor     *actor,
    +                                                        gpointer          user_data)      : Run First

    The ::removed signal is emitted each time a behaviour is not applied to an actor anymore.

    +

    +

    @@ -609,6 +674,6 @@ + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/clutter-Shaders.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/clutter-Shaders.html @@ -8,7 +8,7 @@ - + @@ -62,12 +62,12 @@
    Top -  |  - Description -  |  - Object Hierarchy -  |  - Properties +  |  + Description +  |  + Object Hierarchy +  |  + Properties
    @@ -81,69 +81,148 @@

    Synopsis

    -
    enum                ClutterShaderError;
    +
    +enum                ClutterShaderError;
                         ClutterShader;
                         ClutterShaderClass;
    -ClutterShader *     clutter_shader_new                  (void);
    -void                clutter_shader_set_vertex_source    (ClutterShader *shader,
    -                                                         const gchar *data,
    -                                                         gssize length);
    -const gchar *       clutter_shader_get_vertex_source    (ClutterShader *shader);
    -void                clutter_shader_set_fragment_source  (ClutterShader *shader,
    -                                                         const gchar *data,
    -                                                         gssize length);
    -const gchar *       clutter_shader_get_fragment_source  (ClutterShader *shader);
    -gboolean            clutter_shader_compile              (ClutterShader *shader,
    -                                                         GError **error);
    -void                clutter_shader_release              (ClutterShader *shader);
    -gboolean            clutter_shader_is_compiled          (ClutterShader *shader);
    -void                clutter_shader_set_is_enabled       (ClutterShader *shader,
    -                                                         gboolean enabled);
    -gboolean            clutter_shader_get_is_enabled       (ClutterShader *shader);
    -
    -void                clutter_shader_set_uniform          (ClutterShader *shader,
    -                                                         const gchar *name,
    -                                                         const GValue *value);
    -CoglHandle          clutter_shader_get_cogl_program     (ClutterShader *shader);
    -CoglHandle          clutter_shader_get_cogl_fragment_shader
    -                                                        (ClutterShader *shader);
    -CoglHandle          clutter_shader_get_cogl_vertex_shader
    -                                                        (ClutterShader *shader);
    -
    -#define             CLUTTER_VALUE_HOLDS_SHADER_FLOAT    (x)
    -void                clutter_value_set_shader_float      (GValue *value,
    -                                                         gint size,
    -                                                         const gfloat *floats);
    -const gfloat *      clutter_value_get_shader_float      (const GValue *value,
    -                                                         gsize *length);
    -#define             CLUTTER_VALUE_HOLDS_SHADER_INT      (x)
    -void                clutter_value_set_shader_int        (GValue *value,
    -                                                         gint size,
    -                                                         const gint *ints);
    -const gint *        clutter_value_get_shader_int        (const GValue *value,
    -                                                         gsize *length);
    -#define             CLUTTER_VALUE_HOLDS_SHADER_MATRIX   (x)
    -void                clutter_value_set_shader_matrix     (GValue *value,
    -                                                         gint size,
    -                                                         const gfloat *matrix);
    -const gfloat *      clutter_value_get_shader_matrix     (const GValue *value,
    -                                                         gsize *length);
    +ClutterShader *     clutter_shader_new                  (void);
    +void                clutter_shader_set_vertex_source    (ClutterShader *shader,
    +                                                         const gchar *data,
    +                                                         gssize length);
    +const gchar *       clutter_shader_get_vertex_source    (ClutterShader *shader);
    +void                clutter_shader_set_fragment_source  (ClutterShader *shader,
    +                                                         const gchar *data,
    +                                                         gssize length);
    +const gchar *       clutter_shader_get_fragment_source  (ClutterShader *shader);
    +gboolean            clutter_shader_compile              (ClutterShader *shader,
    +                                                         GError **error);
    +void                clutter_shader_release              (ClutterShader *shader);
    +gboolean            clutter_shader_is_compiled          (ClutterShader *shader);
    +void                clutter_shader_set_is_enabled       (ClutterShader *shader,
    +                                                         gboolean enabled);
    +gboolean            clutter_shader_get_is_enabled       (ClutterShader *shader);
    +
    +void                clutter_shader_set_uniform          (ClutterShader *shader,
    +                                                         const gchar *name,
    +                                                         const GValue *value);
    +CoglHandle          clutter_shader_get_cogl_program     (ClutterShader *shader);
    +CoglHandle          clutter_shader_get_cogl_fragment_shader
    +                                                        (ClutterShader *shader);
    +CoglHandle          clutter_shader_get_cogl_vertex_shader
    +                                                        (ClutterShader *shader);
    +
    +#define             CLUTTER_VALUE_HOLDS_SHADER_FLOAT    (x)
    +void                clutter_value_set_shader_float      (GValue *value,
    +                                                         gint size,
    +                                                         const gfloat *floats);
    +const gfloat *      clutter_value_get_shader_float      (const GValue *value,
    +                                                         gsize *length);
    +#define             CLUTTER_VALUE_HOLDS_SHADER_INT      (x)
    +void                clutter_value_set_shader_int        (GValue *value,
    +                                                         gint size,
    +                                                         const gint *ints);
    +const gint *        clutter_value_get_shader_int        (const GValue *value,
    +                                                         gsize *length);
    +#define             CLUTTER_VALUE_HOLDS_SHADER_MATRIX   (x)
    +void                clutter_value_set_shader_matrix     (GValue *value,
    +                                                         gint size,
    +                                                         const gfloat *matrix);
    +const gfloat *      clutter_value_get_shader_matrix     (const GValue *value,
    +                                                         gsize *length);
     

    Object Hierarchy

    -  GObject
    +  GObject
        +----ClutterShader
     

    Properties

    -  "compiled"                 gboolean              : Read
    -  "enabled"                  gboolean              : Read / Write
    -  "fragment-source"          gchar*                : Read / Write
    -  "vertex-source"            gchar*                : Read / Write
    +  "compiled"                 gboolean              : Read
    +  "enabled"                  gboolean              : Read / Write
    +  "fragment-source"          gchar*                : Read / Write
    +  "vertex-source"            gchar*                : Read / Write
     
    @@ -156,6 +235,8 @@

    ClutterShader is available since Clutter 0.6

    +

    +

    Details

    @@ -169,21 +250,23 @@

    ClutterShader error enumeration

    +

    +

    - + - + - + @@ -198,6 +281,8 @@

    The ClutterShader structure contains only private data and should be accessed using the provided API

    +

    +

    Since 0.6


    @@ -208,14 +293,18 @@

    The ClutterShaderClass structure contains only private data

    +

    +

    Since 0.6


    clutter_shader_new ()

    -
    ClutterShader *     clutter_shader_new                  (void);
    +
    ClutterShader *     clutter_shader_new                  (void);

    Create a new ClutterShader instance.

    +

    +

    CLUTTER_SHADER_ERROR_NO_ASM

    CLUTTER_SHADER_ERROR_NO_ASM

    No ASM shaders support

    CLUTTER_SHADER_ERROR_NO_GLSL

    CLUTTER_SHADER_ERROR_NO_GLSL

    No GLSL shaders support

    CLUTTER_SHADER_ERROR_COMPILE

    CLUTTER_SHADER_ERROR_COMPILE

    Compilation error
    @@ -230,12 +319,18 @@

    clutter_shader_set_vertex_source ()

    -
    void                clutter_shader_set_vertex_source    (ClutterShader *shader,
    -                                                         const gchar *data,
    -                                                         gssize length);
    +
    void                clutter_shader_set_vertex_source    (ClutterShader *shader,
    +                                                         const gchar *data,
    +                                                         gssize length);

    Sets the GLSL source code to be used by a ClutterShader for the vertex program.

    +

    +

    @@ -261,9 +356,13 @@

    clutter_shader_get_vertex_source ()

    -
    const gchar *       clutter_shader_get_vertex_source    (ClutterShader *shader);
    +
    const gchar *       clutter_shader_get_vertex_source    (ClutterShader *shader);

    Query the current GLSL vertex source set on shader.

    +

    +

    @@ -275,7 +374,7 @@ @@ -287,12 +386,18 @@

    clutter_shader_set_fragment_source ()

    -
    void                clutter_shader_set_fragment_source  (ClutterShader *shader,
    -                                                         const gchar *data,
    -                                                         gssize length);
    +
    void                clutter_shader_set_fragment_source  (ClutterShader *shader,
    +                                                         const gchar *data,
    +                                                         gssize length);

    Sets the GLSL source code to be used by a ClutterShader for the fragment program.

    +

    +

    Returns :

    the source of the vertex shader for this -ClutterShader object or NULL. The returned string is owned by the +ClutterShader object or NULL. The returned string is owned by the shader object and should never be modified or freed
    @@ -318,9 +423,13 @@

    clutter_shader_get_fragment_source ()

    -
    const gchar *       clutter_shader_get_fragment_source  (ClutterShader *shader);
    +
    const gchar *       clutter_shader_get_fragment_source  (ClutterShader *shader);

    Query the current GLSL fragment source set on shader.

    +

    +

    @@ -332,7 +441,7 @@ @@ -344,12 +453,20 @@

    clutter_shader_compile ()

    -
    gboolean            clutter_shader_compile              (ClutterShader *shader,
    -                                                         GError **error);
    +
    gboolean            clutter_shader_compile              (ClutterShader *shader,
    +                                                         GError **error);

    Compiles and links GLSL sources set for vertex and fragment shaders for -a ClutterShader. If the compilation fails and a GError return location is +a ClutterShader. If the compilation fails and a GError return location is provided the error will contain the errors from the compiler, if any.

    +

    +

    Returns :

    the source of the fragment shader for this -ClutterShader object or NULL. The returned string is owned by the +ClutterShader object or NULL. The returned string is owned by the shader object and should never be modified or freed
    @@ -360,7 +477,9 @@ - @@ -376,9 +495,11 @@

    clutter_shader_release ()

    -
    void                clutter_shader_release              (ClutterShader *shader);
    +
    void                clutter_shader_release              (ClutterShader *shader);

    Frees up any GL context resources held by the shader.

    +

    +

    error :

    return location for a GError, or NULL + return location for a GError, or NULL
    @@ -392,10 +513,14 @@

    clutter_shader_is_compiled ()

    -
    gboolean            clutter_shader_is_compiled          (ClutterShader *shader);
    +
    gboolean            clutter_shader_is_compiled          (ClutterShader *shader);

    Checks whether shader is is currently compiled, linked and bound to the GL context.

    +

    +

    @@ -406,7 +531,7 @@ - @@ -417,15 +542,19 @@

    clutter_shader_set_is_enabled ()

    -
    void                clutter_shader_set_is_enabled       (ClutterShader *shader,
    -                                                         gboolean enabled);
    +
    void                clutter_shader_set_is_enabled       (ClutterShader *shader,
    +                                                         gboolean enabled);

    Enables a shader. This function will attempt to compile and link the shader, if it isn't already.

    -When enabled is FALSE the default state of the GL pipeline will be +When enabled is FALSE the default state of the GL pipeline will be used instead.

    +

    +

    Returns :

    TRUE if the shader is compiled, linked and ready for use. + TRUE if the shader is compiled, linked and ready for use.
    @@ -446,9 +575,13 @@

    clutter_shader_get_is_enabled ()

    -
    gboolean            clutter_shader_get_is_enabled       (ClutterShader *shader);
    +
    gboolean            clutter_shader_get_is_enabled       (ClutterShader *shader);

    Checks whether shader is enabled.

    +

    +

    @@ -459,7 +592,7 @@ - @@ -470,12 +603,18 @@

    clutter_shader_set_uniform ()

    -
    void                clutter_shader_set_uniform          (ClutterShader *shader,
    -                                                         const gchar *name,
    -                                                         const GValue *value);
    +
    void                clutter_shader_set_uniform          (ClutterShader *shader,
    +                                                         const gchar *name,
    +                                                         const GValue *value);

    Sets a user configurable variable in the GLSL shader programs attached to a ClutterShader.

    +

    +

    Returns :

    TRUE if the shader is enabled. + TRUE if the shader is enabled.
    @@ -492,7 +631,9 @@ @@ -502,9 +643,15 @@

    clutter_shader_get_cogl_program ()

    -
    CoglHandle          clutter_shader_get_cogl_program     (ClutterShader *shader);
    +
    CoglHandle          clutter_shader_get_cogl_program     (ClutterShader *shader);
    +

    +Retrieves the underlying CoglHandle for the shader program.

    -Retrieves the underlying CoglHandle for the shader program.

    +

    value :

    a ClutterShaderFloat, ClutterShaderInt or ClutterShaderMatrix - GValue. + GValue.
    @@ -515,7 +662,9 @@ - @@ -526,10 +675,16 @@

    clutter_shader_get_cogl_fragment_shader ()

    -
    CoglHandle          clutter_shader_get_cogl_fragment_shader
    -                                                        (ClutterShader *shader);
    +
    CoglHandle          clutter_shader_get_cogl_fragment_shader
    +                                                        (ClutterShader *shader);
    +

    +Retrieves the underlying CoglHandle for the fragment shader.

    -Retrieves the underlying CoglHandle for the fragment shader.

    +

    Returns :

    A CoglHandle for the shader program, or NULL + A CoglHandle for the shader program, or NULL
    @@ -540,7 +695,9 @@ - @@ -551,10 +708,16 @@

    clutter_shader_get_cogl_vertex_shader ()

    -
    CoglHandle          clutter_shader_get_cogl_vertex_shader
    -                                                        (ClutterShader *shader);
    +
    CoglHandle          clutter_shader_get_cogl_vertex_shader
    +                                                        (ClutterShader *shader);
    +

    +Retrieves the underlying CoglHandle for the vertex shader.

    -Retrieves the underlying CoglHandle for the vertex shader.

    +

    Returns :

    A CoglHandle for the fragment shader, or NULL + A CoglHandle for the fragment shader, or NULL
    @@ -565,7 +728,9 @@ - @@ -575,16 +740,20 @@
    -

    CLUTTER_VALUE_HOLDS_SHADER_FLOAT()

    +

    CLUTTER_VALUE_HOLDS_SHADER_FLOAT()

    #define CLUTTER_VALUE_HOLDS_SHADER_FLOAT(x) (G_VALUE_HOLDS ((x), CLUTTER_TYPE_SHADER_FLOAT))
     

    -Evaluates to TRUE if x holds a ClutterShaderFloat.

    +Evaluates to TRUE if x holds a ClutterShaderFloat.

    +

    +

    Returns :

    A CoglHandle for the vertex shader, or NULL + A CoglHandle for the vertex shader, or NULL
    -

    x :

    a GValue + a GValue
    @@ -593,18 +762,30 @@

    clutter_value_set_shader_float ()

    -
    void                clutter_value_set_shader_float      (GValue *value,
    -                                                         gint size,
    -                                                         const gfloat *floats);
    -

    -Sets floats as the contents of value. The passed GValue +

    void                clutter_value_set_shader_float      (GValue *value,
    +                                                         gint size,
    +                                                         const gfloat *floats);
    +

    +Sets floats as the contents of value. The passed GValue must have been initialized using CLUTTER_TYPE_SHADER_FLOAT.

    +

    +

    - @@ -624,30 +805,44 @@

    clutter_value_get_shader_float ()

    -
    const gfloat *      clutter_value_get_shader_float      (const GValue *value,
    -                                                         gsize *length);
    +
    const gfloat *      clutter_value_get_shader_float      (const GValue *value,
    +                                                         gsize *length);

    Retrieves the list of floating point values stored inside -the passed GValue. value must have been initialized with +the passed GValue. value must have been initialized with CLUTTER_TYPE_SHADER_FLOAT.

    +

    +

    value :

    a GValue + a GValue
    - @@ -658,16 +853,20 @@
    -

    CLUTTER_VALUE_HOLDS_SHADER_INT()

    +

    CLUTTER_VALUE_HOLDS_SHADER_INT()

    #define CLUTTER_VALUE_HOLDS_SHADER_INT(x) (G_VALUE_HOLDS ((x), CLUTTER_TYPE_SHADER_INT))
     

    -Evaluates to TRUE if x holds a ClutterShaderInt.

    +Evaluates to TRUE if x holds a ClutterShaderInt.

    +

    +

    value :

    a GValue + a GValue

    length :

    return location for the number of returned floating - point values, or NULL + point values, or NULL

    Returns :

    the pointer to a list of floating point values. - The returned value is owned by the GValue and should never + The returned value is owned by the GValue and should never be modified or freed.
    -

    x :

    a GValue + a GValue
    @@ -676,18 +875,30 @@

    clutter_value_set_shader_int ()

    -
    void                clutter_value_set_shader_int        (GValue *value,
    -                                                         gint size,
    -                                                         const gint *ints);
    -

    -Sets ints as the contents of value. The passed GValue +

    void                clutter_value_set_shader_int        (GValue *value,
    +                                                         gint size,
    +                                                         const gint *ints);
    +

    +Sets ints as the contents of value. The passed GValue must have been initialized using CLUTTER_TYPE_SHADER_INT.

    +

    +

    - @@ -707,30 +918,44 @@

    clutter_value_get_shader_int ()

    -
    const gint *        clutter_value_get_shader_int        (const GValue *value,
    -                                                         gsize *length);
    +
    const gint *        clutter_value_get_shader_int        (const GValue *value,
    +                                                         gsize *length);

    Retrieves the list of integer values stored inside the passed -GValue. value must have been initialized with +GValue. value must have been initialized with CLUTTER_TYPE_SHADER_INT.

    +

    +

    value :

    a GValue + a GValue
    - @@ -741,16 +966,20 @@
    -

    CLUTTER_VALUE_HOLDS_SHADER_MATRIX()

    +

    CLUTTER_VALUE_HOLDS_SHADER_MATRIX()

    #define CLUTTER_VALUE_HOLDS_SHADER_MATRIX(x) (G_VALUE_HOLDS ((x), CLUTTER_TYPE_SHADER_MATRIX))
     

    -Evaluates to TRUE if x holds a ClutterShaderMatrix.

    +Evaluates to TRUE if x holds a ClutterShaderMatrix.

    +

    +

    value :

    a GValue + a GValue

    length :

    return location for the number of returned integer - values, or NULL + values, or NULL

    Returns :

    the pointer to a list of integer values. - The returned value is owned by the GValue and should never + The returned value is owned by the GValue and should never be modified or freed.
    -

    x :

    a GValue + a GValue
    @@ -759,18 +988,30 @@

    clutter_value_set_shader_matrix ()

    -
    void                clutter_value_set_shader_matrix     (GValue *value,
    -                                                         gint size,
    -                                                         const gfloat *matrix);
    -

    -Sets matrix as the contents of value. The passed GValue +

    void                clutter_value_set_shader_matrix     (GValue *value,
    +                                                         gint size,
    +                                                         const gfloat *matrix);
    +

    +Sets matrix as the contents of value. The passed GValue must have been initialized using CLUTTER_TYPE_SHADER_MATRIX.

    +

    +

    - @@ -790,27 +1031,39 @@

    clutter_value_get_shader_matrix ()

    -
    const gfloat *      clutter_value_get_shader_matrix     (const GValue *value,
    -                                                         gsize *length);
    +
    const gfloat *      clutter_value_get_shader_matrix     (const GValue *value,
    +                                                         gsize *length);

    Retrieves a matrix of floating point values stored inside -the passed GValue. value must have been initialized with +the passed GValue. value must have been initialized with CLUTTER_TYPE_SHADER_MATRIX.

    +

    +

    value :

    a GValue + a GValue
    - - + - +

    value :

    a GValue + a GValue

    length :

    out. out. out. out.

    Returns :

    array length=length) (transfer none. array length=length. transfer none length=length. array length=length) (transfer none. array length=length. transfer none.
    @@ -821,45 +1074,61 @@

    Property Details

    The "compiled" property

    -
      "compiled"                 gboolean              : Read
    +
      "compiled"                 gboolean              : Read

    Whether the shader is compiled and linked, ready for use in the GL context.

    +

    +

    Default value: FALSE

    -

    Since 0.8

    +

    Since 0.8


    The "enabled" property

    -
      "enabled"                  gboolean              : Read / Write
    +
      "enabled"                  gboolean              : Read / Write

    Whether the shader is currently used in the GL rendering pipeline.

    +

    +

    Default value: FALSE

    -

    Since 0.6

    +

    Since 0.6


    The "fragment-source" property

    -
      "fragment-source"          gchar*                : Read / Write
    +
      "fragment-source"          gchar*                : Read / Write

    GLSL source code for the fragment shader part of the shader program.

    +

    +

    Default value: NULL

    -

    Since 0.6

    +

    Since 0.6


    The "vertex-source" property

    -
      "vertex-source"            gchar*                : Read / Write
    +
      "vertex-source"            gchar*                : Read / Write

    GLSL source code for the vertex shader part of the shader program, if any

    +

    +

    Default value: NULL

    -

    Since 0.6

    +

    Since 0.6

    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/creating-your-own-behaviours.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/creating-your-own-behaviours.html @@ -8,7 +8,7 @@ - + @@ -79,7 +79,7 @@ is needed to create a spcific animation.

    In order to implement a new ClutterBehaviour subclass the usual machinery for subclassing a GObject should be used. The new subclass - then just overides the ClutterBehaviour::alpha_notify() method. This + then just overides the ""alpha_notify() method. This method is passed an alpha value which is then used to compute modifications to any actors the behaviour is applied to.

    @@ -126,6 +126,6 @@
    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ClutterAnimatable.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ClutterAnimatable.html @@ -8,7 +8,7 @@ - + @@ -62,10 +62,10 @@ Top -  |  - Description -  |  - Object Hierarchy +  |  + Description +  |  + Object Hierarchy
    @@ -79,15 +79,28 @@

    Synopsis

    -
                        ClutterAnimatable;
    +
    +                    ClutterAnimatable;
                         ClutterAnimatableIface;
    -gboolean            clutter_animatable_animate_property (ClutterAnimatable *animatable,
    -                                                         ClutterAnimation *animation,
    -                                                         const gchar *property_name,
    -                                                         const GValue *initial_value,
    -                                                         const GValue *final_value,
    -                                                         gdouble progress,
    -                                                         GValue *value);
    +gboolean            clutter_animatable_animate_property (ClutterAnimatable *animatable,
    +                                                         ClutterAnimation *animation,
    +                                                         const gchar *property_name,
    +                                                         const GValue *initial_value,
    +                                                         const GValue *final_value,
    +                                                         gdouble progress,
    +                                                         GValue *value);
     
    @@ -100,7 +113,9 @@

    Description

    -ClutterAnimatable is an interface that allows a GObject class +ClutterAnimatable is an interface that allows a GObject class to control how a ClutterAnimation will animate a property.

    @@ -120,6 +135,8 @@

    ClutterAnimatable is available since Clutter 1.0

    +

    +

    Details

    @@ -129,6 +146,8 @@

    ClutterAnimatable is an opaque structure whose members cannot be directly accessed

    +

    +

    Since 1.0


    @@ -145,12 +164,16 @@ } ClutterAnimatableIface;

    -Base interface for GObjects that can be animated by a +Base interface for GObjects that can be animated by a a ClutterAnimation.

    +

    +

    - + @@ -160,24 +183,40 @@

    clutter_animatable_animate_property ()

    -
    gboolean            clutter_animatable_animate_property (ClutterAnimatable *animatable,
    -                                                         ClutterAnimation *animation,
    -                                                         const gchar *property_name,
    -                                                         const GValue *initial_value,
    -                                                         const GValue *final_value,
    -                                                         gdouble progress,
    -                                                         GValue *value);
    +
    gboolean            clutter_animatable_animate_property (ClutterAnimatable *animatable,
    +                                                         ClutterAnimation *animation,
    +                                                         const gchar *property_name,
    +                                                         const GValue *initial_value,
    +                                                         const GValue *final_value,
    +                                                         gdouble progress,
    +                                                         GValue *value);

    Calls the animate_property() virtual function for animatable.

    -The initial_value and final_value GValues must contain +The initial_value and final_value GValues must contain the same type; value must have been initialized to the same type of initial_value and final_value.

    All implementation of the ClutterAnimatable interface must implement this function.

    +

    +

    animate_property ()

    animate_property ()

    virtual function for animating a property
    @@ -218,8 +257,8 @@ - @@ -231,6 +270,6 @@ + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ClutterBoxLayout.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ClutterBoxLayout.html @@ -8,7 +8,7 @@ - + @@ -62,12 +62,12 @@

    Returns :

    TRUE if the value has been validated and can - be applied to the ClutterAnimatable, and FALSE otherwise + TRUE if the value has been validated and can + be applied to the ClutterAnimatable, and FALSE otherwise
    Top -  |  - Description -  |  - Object Hierarchy -  |  - Properties +  |  + Description +  |  + Object Hierarchy +  |  + Properties
    @@ -81,70 +81,117 @@

    Synopsis

    -
    enum                ClutterBoxAlignment;
    +
    +enum                ClutterBoxAlignment;
                         ClutterBoxLayout;
                         ClutterBoxLayoutClass;
    -ClutterLayoutManager * clutter_box_layout_new           (void);
    -void                clutter_box_layout_set_pack_start   (ClutterBoxLayout *layout,
    -                                                         gboolean pack_start);
    -gboolean            clutter_box_layout_get_pack_start   (ClutterBoxLayout *layout);
    -void                clutter_box_layout_set_spacing      (ClutterBoxLayout *layout,
    -                                                         guint spacing);
    -guint               clutter_box_layout_get_spacing      (ClutterBoxLayout *layout);
    -void                clutter_box_layout_set_vertical     (ClutterBoxLayout *layout,
    -                                                         gboolean vertical);
    -gboolean            clutter_box_layout_get_vertical     (ClutterBoxLayout *layout);
    -
    -void                clutter_box_layout_pack             (ClutterBoxLayout *layout,
    -                                                         ClutterActor *actor,
    -                                                         gboolean expand,
    -                                                         gboolean x_fill,
    -                                                         gboolean y_fill,
    -                                                         ClutterBoxAlignment x_align,
    -                                                         ClutterBoxAlignment y_align);
    -
    -void                clutter_box_layout_set_alignment    (ClutterBoxLayout *layout,
    -                                                         ClutterActor *actor,
    -                                                         ClutterBoxAlignment x_align,
    -                                                         ClutterBoxAlignment y_align);
    -void                clutter_box_layout_get_alignment    (ClutterBoxLayout *layout,
    -                                                         ClutterActor *actor,
    -                                                         ClutterBoxAlignment *x_align,
    -                                                         ClutterBoxAlignment *y_align);
    -void                clutter_box_layout_set_expand       (ClutterBoxLayout *layout,
    -                                                         ClutterActor *actor,
    -                                                         gboolean expand);
    -gboolean            clutter_box_layout_get_expand       (ClutterBoxLayout *layout,
    -                                                         ClutterActor *actor);
    -void                clutter_box_layout_set_fill         (ClutterBoxLayout *layout,
    -                                                         ClutterActor *actor,
    -                                                         gboolean x_fill,
    -                                                         gboolean y_fill);
    -void                clutter_box_layout_get_fill         (ClutterBoxLayout *layout,
    -                                                         ClutterActor *actor,
    -                                                         gboolean *x_fill,
    -                                                         gboolean *y_fill);
    -
    -void                clutter_box_layout_set_use_animations
    -                                                        (ClutterBoxLayout *layout,
    -                                                         gboolean animate);
    -gboolean            clutter_box_layout_get_use_animations
    -                                                        (ClutterBoxLayout *layout);
    -void                clutter_box_layout_set_easing_duration
    -                                                        (ClutterBoxLayout *layout,
    -                                                         guint msecs);
    -guint               clutter_box_layout_get_easing_duration
    -                                                        (ClutterBoxLayout *layout);
    -void                clutter_box_layout_set_easing_mode  (ClutterBoxLayout *layout,
    -                                                         gulong mode);
    -gulong              clutter_box_layout_get_easing_mode  (ClutterBoxLayout *layout);
    +ClutterLayoutManager * clutter_box_layout_new           (void);
    +void                clutter_box_layout_set_pack_start   (ClutterBoxLayout *layout,
    +                                                         gboolean pack_start);
    +gboolean            clutter_box_layout_get_pack_start   (ClutterBoxLayout *layout);
    +void                clutter_box_layout_set_spacing      (ClutterBoxLayout *layout,
    +                                                         guint spacing);
    +guint               clutter_box_layout_get_spacing      (ClutterBoxLayout *layout);
    +void                clutter_box_layout_set_vertical     (ClutterBoxLayout *layout,
    +                                                         gboolean vertical);
    +gboolean            clutter_box_layout_get_vertical     (ClutterBoxLayout *layout);
    +
    +void                clutter_box_layout_pack             (ClutterBoxLayout *layout,
    +                                                         ClutterActor *actor,
    +                                                         gboolean expand,
    +                                                         gboolean x_fill,
    +                                                         gboolean y_fill,
    +                                                         ClutterBoxAlignment x_align,
    +                                                         ClutterBoxAlignment y_align);
    +
    +void                clutter_box_layout_set_alignment    (ClutterBoxLayout *layout,
    +                                                         ClutterActor *actor,
    +                                                         ClutterBoxAlignment x_align,
    +                                                         ClutterBoxAlignment y_align);
    +void                clutter_box_layout_get_alignment    (ClutterBoxLayout *layout,
    +                                                         ClutterActor *actor,
    +                                                         ClutterBoxAlignment *x_align,
    +                                                         ClutterBoxAlignment *y_align);
    +void                clutter_box_layout_set_expand       (ClutterBoxLayout *layout,
    +                                                         ClutterActor *actor,
    +                                                         gboolean expand);
    +gboolean            clutter_box_layout_get_expand       (ClutterBoxLayout *layout,
    +                                                         ClutterActor *actor);
    +void                clutter_box_layout_set_fill         (ClutterBoxLayout *layout,
    +                                                         ClutterActor *actor,
    +                                                         gboolean x_fill,
    +                                                         gboolean y_fill);
    +void                clutter_box_layout_get_fill         (ClutterBoxLayout *layout,
    +                                                         ClutterActor *actor,
    +                                                         gboolean *x_fill,
    +                                                         gboolean *y_fill);
    +
    +void                clutter_box_layout_set_use_animations
    +                                                        (ClutterBoxLayout *layout,
    +                                                         gboolean animate);
    +gboolean            clutter_box_layout_get_use_animations
    +                                                        (ClutterBoxLayout *layout);
    +void                clutter_box_layout_set_easing_duration
    +                                                        (ClutterBoxLayout *layout,
    +                                                         guint msecs);
    +guint               clutter_box_layout_get_easing_duration
    +                                                        (ClutterBoxLayout *layout);
    +void                clutter_box_layout_set_easing_mode  (ClutterBoxLayout *layout,
    +                                                         gulong mode);
    +gulong              clutter_box_layout_get_easing_mode  (ClutterBoxLayout *layout);
     

    Object Hierarchy

    -  GObject
    -   +----GInitiallyUnowned
    +  GObject
    +   +----GInitiallyUnowned
              +----ClutterLayoutManager
                    +----ClutterBoxLayout
     
    @@ -152,12 +199,24 @@

    Properties

    -  "easing-duration"          guint                 : Read / Write
    -  "easing-mode"              gulong                : Read / Write
    -  "pack-start"               gboolean              : Read / Write
    -  "spacing"                  guint                 : Read / Write
    -  "use-animations"           gboolean              : Read / Write
    -  "vertical"                 gboolean              : Read / Write
    +  "easing-duration"          guint                 : Read / Write
    +  "easing-mode"              gulong                : Read / Write
    +  "pack-start"               gboolean              : Read / Write
    +  "spacing"                  guint                 : Read / Write
    +  "use-animations"           gboolean              : Read / Write
    +  "vertical"                 gboolean              : Read / Write
     
    @@ -191,7 +250,7 @@

    Figure 6. Box layout

    The image shows a ClutterBoxLayout with the - "vertical" property set to FALSE.

    + "vertical" property set to FALSE.

    Box layout
    @@ -208,6 +267,8 @@

    ClutterBoxLayout is available since Clutter 1.2

    +

    +

    Details

    @@ -221,23 +282,25 @@

    The alignment policies available on each axis of the ClutterBoxLayout

    +

    +

    - + - + - + @@ -252,6 +315,8 @@

    The ClutterBoxLayout structure contains only private data and should be accessed using the provided API

    +

    +

    Since 1.2


    @@ -263,14 +328,18 @@

    The ClutterBoxLayoutClass structure contains only private data and should be accessed using the provided API

    +

    +

    Since 1.2


    clutter_box_layout_new ()

    -
    ClutterLayoutManager * clutter_box_layout_new           (void);
    +
    ClutterLayoutManager * clutter_box_layout_new           (void);

    Creates a new ClutterBoxLayout layout manager

    +

    +

    CLUTTER_BOX_ALIGNMENT_START

    CLUTTER_BOX_ALIGNMENT_START

    Align the child to the top or to to the left, depending on the used axis

    CLUTTER_BOX_ALIGNMENT_END

    CLUTTER_BOX_ALIGNMENT_END

    Align the child to the bottom or to the right, depending on the used axis

    CLUTTER_BOX_ALIGNMENT_CENTER

    CLUTTER_BOX_ALIGNMENT_CENTER

    Align the child to the center
    @@ -285,11 +354,15 @@

    clutter_box_layout_set_pack_start ()

    -
    void                clutter_box_layout_set_pack_start   (ClutterBoxLayout *layout,
    -                                                         gboolean pack_start);
    +
    void                clutter_box_layout_set_pack_start   (ClutterBoxLayout *layout,
    +                                                         gboolean pack_start);

    Sets whether children of layout should be layed out by appending them or by prepending them

    +

    +

    @@ -300,7 +373,7 @@ - @@ -311,9 +384,13 @@

    clutter_box_layout_get_pack_start ()

    -
    gboolean            clutter_box_layout_get_pack_start   (ClutterBoxLayout *layout);
    +
    gboolean            clutter_box_layout_get_pack_start   (ClutterBoxLayout *layout);

    Retrieves the value set using clutter_box_layout_set_pack_start()

    +

    +

    pack_start :

    TRUE if the layout should pack children at the + TRUE if the layout should pack children at the beginning of the layout
    @@ -324,8 +401,8 @@ - @@ -336,10 +413,14 @@

    clutter_box_layout_set_spacing ()

    -
    void                clutter_box_layout_set_spacing      (ClutterBoxLayout *layout,
    -                                                         guint spacing);
    +
    void                clutter_box_layout_set_spacing      (ClutterBoxLayout *layout,
    +                                                         guint spacing);

    Sets the spacing between children of layout

    +

    +

    Returns :

    TRUE if the ClutterBoxLayout should pack children - at the beginning of the layout, and FALSE otherwise + TRUE if the ClutterBoxLayout should pack children + at the beginning of the layout, and FALSE otherwise
    @@ -360,9 +441,13 @@

    clutter_box_layout_get_spacing ()

    -
    guint               clutter_box_layout_get_spacing      (ClutterBoxLayout *layout);
    +
    guint               clutter_box_layout_get_spacing      (ClutterBoxLayout *layout);

    Retrieves the spacing set using clutter_box_layout_set_spacing()

    +

    +

    @@ -384,11 +469,15 @@

    clutter_box_layout_set_vertical ()

    -
    void                clutter_box_layout_set_vertical     (ClutterBoxLayout *layout,
    -                                                         gboolean vertical);
    +
    void                clutter_box_layout_set_vertical     (ClutterBoxLayout *layout,
    +                                                         gboolean vertical);

    Sets whether layout should arrange its children vertically alongside the Y axis, instead of horizontally alongside the X axis

    +

    +

    @@ -399,7 +488,7 @@ - @@ -409,10 +498,14 @@

    clutter_box_layout_get_vertical ()

    -
    gboolean            clutter_box_layout_get_vertical     (ClutterBoxLayout *layout);
    +
    gboolean            clutter_box_layout_get_vertical     (ClutterBoxLayout *layout);

    Retrieves the orientation of the layout as set using the clutter_box_layout_set_vertical() function

    +

    +

    vertical :

    TRUE if the layout should be vertical + TRUE if the layout should be vertical
    @@ -423,8 +516,8 @@ - @@ -435,16 +528,24 @@

    clutter_box_layout_pack ()

    -
    void                clutter_box_layout_pack             (ClutterBoxLayout *layout,
    -                                                         ClutterActor *actor,
    -                                                         gboolean expand,
    -                                                         gboolean x_fill,
    -                                                         gboolean y_fill,
    -                                                         ClutterBoxAlignment x_align,
    -                                                         ClutterBoxAlignment y_align);
    +
    void                clutter_box_layout_pack             (ClutterBoxLayout *layout,
    +                                                         ClutterActor *actor,
    +                                                         gboolean expand,
    +                                                         gboolean x_fill,
    +                                                         gboolean y_fill,
    +                                                         ClutterBoxAlignment x_align,
    +                                                         ClutterBoxAlignment y_align);

    Packs actor inside the ClutterContainer associated to layout and sets the layout properties

    +

    +

    Returns :

    TRUE if the ClutterBoxLayout is arranging its children - vertically, and FALSE otherwise + TRUE if the ClutterBoxLayout is arranging its children + vertically, and FALSE otherwise
    @@ -490,13 +591,15 @@

    clutter_box_layout_set_alignment ()

    -
    void                clutter_box_layout_set_alignment    (ClutterBoxLayout *layout,
    -                                                         ClutterActor *actor,
    -                                                         ClutterBoxAlignment x_align,
    -                                                         ClutterBoxAlignment y_align);
    +
    void                clutter_box_layout_set_alignment    (ClutterBoxLayout *layout,
    +                                                         ClutterActor *actor,
    +                                                         ClutterBoxAlignment x_align,
    +                                                         ClutterBoxAlignment y_align);

    Sets the horizontal and vertical alignment policies for actor inside layout

    +

    +

    @@ -527,13 +630,15 @@

    clutter_box_layout_get_alignment ()

    -
    void                clutter_box_layout_get_alignment    (ClutterBoxLayout *layout,
    -                                                         ClutterActor *actor,
    -                                                         ClutterBoxAlignment *x_align,
    -                                                         ClutterBoxAlignment *y_align);
    +
    void                clutter_box_layout_get_alignment    (ClutterBoxLayout *layout,
    +                                                         ClutterActor *actor,
    +                                                         ClutterBoxAlignment *x_align,
    +                                                         ClutterBoxAlignment *y_align);

    Retrieves the horizontal and vertical alignment policies for actor as set using clutter_box_layout_pack() or clutter_box_layout_set_alignment()

    +

    +

    @@ -549,11 +654,11 @@ - + - +

    x_align :

    return location for the horizontal alignment policy. out. return location for the horizontal alignment policy. out.

    y_align :

    return location for the vertical alignment policy. out. return location for the vertical alignment policy. out.
    @@ -562,11 +667,15 @@

    clutter_box_layout_set_expand ()

    -
    void                clutter_box_layout_set_expand       (ClutterBoxLayout *layout,
    -                                                         ClutterActor *actor,
    -                                                         gboolean expand);
    +
    void                clutter_box_layout_set_expand       (ClutterBoxLayout *layout,
    +                                                         ClutterActor *actor,
    +                                                         gboolean expand);

    Sets whether actor should expand inside layout

    +

    +

    @@ -592,10 +701,14 @@

    clutter_box_layout_get_expand ()

    -
    gboolean            clutter_box_layout_get_expand       (ClutterBoxLayout *layout,
    -                                                         ClutterActor *actor);
    +
    gboolean            clutter_box_layout_get_expand       (ClutterBoxLayout *layout,
    +                                                         ClutterActor *actor);

    Retrieves whether actor should expand inside layout

    +

    +

    @@ -611,7 +724,7 @@ - @@ -622,13 +735,19 @@

    clutter_box_layout_set_fill ()

    -
    void                clutter_box_layout_set_fill         (ClutterBoxLayout *layout,
    -                                                         ClutterActor *actor,
    -                                                         gboolean x_fill,
    -                                                         gboolean y_fill);
    +
    void                clutter_box_layout_set_fill         (ClutterBoxLayout *layout,
    +                                                         ClutterActor *actor,
    +                                                         gboolean x_fill,
    +                                                         gboolean y_fill);

    Sets the horizontal and vertical fill policies for actor inside layout

    +

    +

    Returns :

    TRUE if the ClutterActor should expand, FALSE otherwise + TRUE if the ClutterActor should expand, FALSE otherwise
    @@ -659,13 +778,19 @@

    clutter_box_layout_get_fill ()

    -
    void                clutter_box_layout_get_fill         (ClutterBoxLayout *layout,
    -                                                         ClutterActor *actor,
    -                                                         gboolean *x_fill,
    -                                                         gboolean *y_fill);
    +
    void                clutter_box_layout_get_fill         (ClutterBoxLayout *layout,
    +                                                         ClutterActor *actor,
    +                                                         gboolean *x_fill,
    +                                                         gboolean *y_fill);

    Retrieves the horizontal and vertical fill policies for actor as set using clutter_box_layout_pack() or clutter_box_layout_set_fill()

    +

    +

    @@ -681,11 +806,11 @@ - + - +

    x_fill :

    return location for the horizontal fill policy. out. return location for the horizontal fill policy. out.

    y_fill :

    return location for the vertical fill policy. out. return location for the vertical fill policy. out.
    @@ -694,9 +819,11 @@

    clutter_box_layout_set_use_animations ()

    -
    void                clutter_box_layout_set_use_animations
    -                                                        (ClutterBoxLayout *layout,
    -                                                         gboolean animate);
    +
    void                clutter_box_layout_set_use_animations
    +                                                        (ClutterBoxLayout *layout,
    +                                                         gboolean animate);

    Sets whether layout should animate changes in the layout properties

    @@ -704,6 +831,8 @@ 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()

    +

    +

    @@ -714,7 +843,7 @@ - @@ -724,13 +853,17 @@

    clutter_box_layout_get_use_animations ()

    -
    gboolean            clutter_box_layout_get_use_animations
    -                                                        (ClutterBoxLayout *layout);
    +
    gboolean            clutter_box_layout_get_use_animations
    +                                                        (ClutterBoxLayout *layout);

    Retrieves whether layout should animate changes in the layout properties

    Since clutter_box_layout_set_use_animations()

    +

    +

    animate :

    TRUE if the layout should use animations + TRUE if the layout should use animations
    @@ -741,7 +874,7 @@ - @@ -752,9 +885,11 @@

    clutter_box_layout_set_easing_duration ()

    -
    void                clutter_box_layout_set_easing_duration
    -                                                        (ClutterBoxLayout *layout,
    -                                                         guint msecs);
    +
    void                clutter_box_layout_set_easing_duration
    +                                                        (ClutterBoxLayout *layout,
    +                                                         guint msecs);

    Sets the duration of the animations used by layout when animating changes in the layout properties @@ -762,6 +897,8 @@

    Use clutter_box_layout_set_use_animations() to enable and disable the animations

    +

    +

    Returns :

    TRUE if the animations should be used, FALSE otherwise + TRUE if the animations should be used, FALSE otherwise
    @@ -782,10 +919,14 @@

    clutter_box_layout_get_easing_duration ()

    -
    guint               clutter_box_layout_get_easing_duration
    -                                                        (ClutterBoxLayout *layout);
    +
    guint               clutter_box_layout_get_easing_duration
    +                                                        (ClutterBoxLayout *layout);

    Retrieves the duration set using clutter_box_layout_set_easing_duration()

    +

    +

    @@ -807,8 +948,10 @@

    clutter_box_layout_set_easing_mode ()

    -
    void                clutter_box_layout_set_easing_mode  (ClutterBoxLayout *layout,
    -                                                         gulong mode);
    +
    void                clutter_box_layout_set_easing_mode  (ClutterBoxLayout *layout,
    +                                                         gulong mode);

    Sets the easing mode to be used by layout when animating changes in layout properties @@ -816,6 +959,8 @@

    Use clutter_box_layout_set_use_animations() to enable and disable the animations

    +

    +

    @@ -837,9 +982,13 @@

    clutter_box_layout_get_easing_mode ()

    -
    gulong              clutter_box_layout_get_easing_mode  (ClutterBoxLayout *layout);
    +
    gulong              clutter_box_layout_get_easing_mode  (ClutterBoxLayout *layout);

    Retrieves the easing mode set using clutter_box_layout_set_easing_mode()

    +

    +

    @@ -863,77 +1012,101 @@

    Property Details

    The "easing-duration" property

    -
      "easing-duration"          guint                 : Read / Write
    +
      "easing-duration"          guint                 : Read / Write

    The duration of the animations, in case "use-animations" -is set to TRUE +is set to TRUE

    The duration is expressed in milliseconds

    +

    +

    Default value: 500

    -

    Since 1.2

    +

    Since 1.2


    The "easing-mode" property

    -
      "easing-mode"              gulong                : Read / Write
    +
      "easing-mode"              gulong                : Read / Write

    The easing mode for the animations, in case -"use-animations" is set to TRUE +"use-animations" is set to TRUE

    -The easing mode has the same semantics of "mode": it can +The easing mode has the same semantics of "mode:" it can either be a value from the ClutterAnimationMode enumeration, like -CLUTTER_EASE_OUT_CUBIC, or a logical id as returned by +CLUTTER_EASE_OUT_CUBIC, or a logical id as returned by clutter_alpha_register_func()

    -The default value is CLUTTER_EASE_OUT_CUBIC

    -

    Since 1.2

    +The default value is CLUTTER_EASE_OUT_CUBIC

    +

    +

    +

    Since 1.2


    The "pack-start" property

    -
      "pack-start"               gboolean              : Read / Write
    +
      "pack-start"               gboolean              : Read / Write

    Whether the ClutterBoxLayout should pack items at the start or append them at the end

    +

    +

    Default value: FALSE

    -

    Since 1.2

    +

    Since 1.2


    The "spacing" property

    -
      "spacing"                  guint                 : Read / Write
    +
      "spacing"                  guint                 : Read / Write

    The spacing between children of the ClutterBoxLayout, in pixels

    +

    +

    Default value: 0

    -

    Since 1.2

    +

    Since 1.2


    The "use-animations" property

    -
      "use-animations"           gboolean              : Read / Write
    +
      "use-animations"           gboolean              : Read / Write

    Whether the ClutterBoxLayout should animate changes in the layout properties

    +

    +

    Default value: FALSE

    -

    Since 1.2

    +

    Since 1.2


    The "vertical" property

    -
      "vertical"                 gboolean              : Read / Write
    +
      "vertical"                 gboolean              : Read / Write

    Whether the ClutterBoxLayout should arrange its children alongside the Y axis, instead of alongside the X axis

    +

    +

    Default value: FALSE

    -

    Since 1.2

    +

    Since 1.2

    + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ClutterClone.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ClutterClone.html @@ -8,7 +8,7 @@ - + @@ -62,14 +62,14 @@
    Top -  |  - Description -  |  - Object Hierarchy -  |  - Implemented Interfaces -  |  - Properties +  |  + Description +  |  + Object Hierarchy +  |  + Implemented Interfaces +  |  + Properties
    @@ -83,19 +83,24 @@

    Object Hierarchy

    -  GObject
    -   +----GInitiallyUnowned
    +  GObject
    +   +----GInitiallyUnowned
              +----ClutterActor
                    +----ClutterClone
     
    @@ -109,7 +114,7 @@

    Properties

    -  "source"                   ClutterActor*         : Read / Write / Construct
    +  "source"                   ClutterActor*         : Read / Write / Construct
     
    @@ -133,6 +138,8 @@

    ClutterClone is available since Clutter 1.0

    +

    +

    Details

    @@ -142,6 +149,8 @@

    The ClutterClone structure contains only private data and should be accessed using the provided API

    +

    +

    Since 1.0


    @@ -152,20 +161,24 @@

    The ClutterCloneClass structure contains only private data

    +

    +

    Since 1.0


    clutter_clone_new ()

    -
    ClutterActor *      clutter_clone_new                   (ClutterActor *source);
    +
    ClutterActor *      clutter_clone_new                   (ClutterActor *source);

    Creates a new ClutterActor which clones source/

    +

    +

    - @@ -181,10 +194,12 @@

    clutter_clone_set_source ()

    -
    void                clutter_clone_set_source            (ClutterClone *clone,
    -                                                         ClutterActor *source);
    +
    void                clutter_clone_set_source            (ClutterClone *clone,
    +                                                         ClutterActor *source);

    Sets source as the source actor to be cloned by clone.

    +

    +

    source :

    a ClutterActor, or NULL + a ClutterActor, or NULL
    @@ -195,7 +210,7 @@ - @@ -205,9 +220,11 @@

    clutter_clone_get_source ()

    -
    ClutterActor *      clutter_clone_get_source            (ClutterClone *clone);
    +
    ClutterActor *      clutter_clone_get_source            (ClutterClone *clone);

    Retrieves the source ClutterActor being cloned by clone

    +

    +

    source :

    a ClutterActor, or NULL + a ClutterActor, or NULL
    @@ -218,7 +235,7 @@ - +

    Returns :

    the actor source for the clone. transfer none. the actor source for the clone. transfer none.
    @@ -229,15 +246,17 @@

    Property Details

    The "source" property

    -
      "source"                   ClutterActor*         : Read / Write / Construct
    +
      "source"                   ClutterActor*         : Read / Write / Construct

    This property specifies the source actor being cloned.

    -

    Since 1.0

    +

    +

    +

    Since 1.0

    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/clutter-animation-conclusion.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/clutter-animation-conclusion.html @@ -8,7 +8,7 @@ - + @@ -75,6 +75,6 @@
    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/clutteranimation.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/clutteranimation.html @@ -8,7 +8,7 @@ - + @@ -132,6 +132,6 @@
    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/go01.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/go01.html @@ -8,7 +8,7 @@ - + @@ -61,7 +61,7 @@

    -Glossary

    +Glossary
    actor
    @@ -149,6 +149,6 @@
    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/migrating-ClutterEffect.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/migrating-ClutterEffect.html @@ -8,7 +8,7 @@ - + @@ -189,6 +189,6 @@
    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ch03.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ch03.html @@ -8,7 +8,7 @@ - + @@ -61,7 +61,7 @@

    -Container actors

    +Container actors
    ClutterGroup — A fixed layout container @@ -76,6 +76,6 @@
    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/clutter-Features.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/clutter-Features.html @@ -8,7 +8,7 @@ - + @@ -62,8 +62,8 @@ Top -  |  - Description +  |  + Description
    @@ -77,9 +77,12 @@
    @@ -94,7 +97,13 @@ run-time.

    -See also cogl_get_features() and CoglFeatureFlags

    +See also cogl_get_features() and CoglFeatureFlags

    +

    +

    Details

    @@ -118,61 +127,63 @@

    Runtime flags indicating specific features available via Clutter window sysytem and graphics backend.

    +

    +

    - + - + - + - + - + - + - + - + - + - + - + @@ -183,10 +194,14 @@

    clutter_feature_available ()

    -
    gboolean            clutter_feature_available           (ClutterFeatureFlags feature);
    +
    gboolean            clutter_feature_available           (ClutterFeatureFlags feature);

    Checks whether feature is available. feature can be a logical OR of ClutterFeatureFlags.

    +

    +

    CLUTTER_FEATURE_TEXTURE_NPOT

    CLUTTER_FEATURE_TEXTURE_NPOT

    Set if NPOTS textures supported.

    CLUTTER_FEATURE_SYNC_TO_VBLANK

    CLUTTER_FEATURE_SYNC_TO_VBLANK

    Set if vblank syncing supported.

    CLUTTER_FEATURE_TEXTURE_YUV

    CLUTTER_FEATURE_TEXTURE_YUV

    Set if YUV based textures supported.

    CLUTTER_FEATURE_TEXTURE_READ_PIXELS

    CLUTTER_FEATURE_TEXTURE_READ_PIXELS

    Set if texture pixels can be read.

    CLUTTER_FEATURE_STAGE_STATIC

    CLUTTER_FEATURE_STAGE_STATIC

    Set if stage size if fixed (i.e framebuffer)

    CLUTTER_FEATURE_STAGE_USER_RESIZE

    CLUTTER_FEATURE_STAGE_USER_RESIZE

    Set if stage is able to be user resized.

    CLUTTER_FEATURE_STAGE_CURSOR

    CLUTTER_FEATURE_STAGE_CURSOR

    Set if stage has a graphical cursor.

    CLUTTER_FEATURE_SHADERS_GLSL

    CLUTTER_FEATURE_SHADERS_GLSL

    Set if the backend supports GLSL shaders.

    CLUTTER_FEATURE_OFFSCREEN

    CLUTTER_FEATURE_OFFSCREEN

    Set if the backend supports offscreen rendering.

    CLUTTER_FEATURE_STAGE_MULTIPLE

    CLUTTER_FEATURE_STAGE_MULTIPLE

    Set if multiple stages are supported.

    CLUTTER_FEATURE_SWAP_EVENTS

    CLUTTER_FEATURE_SWAP_EVENTS

    Set if the GLX_INTEL_swap_event is supported.
    @@ -197,7 +212,7 @@ - @@ -208,9 +223,11 @@

    clutter_feature_get_all ()

    -
    ClutterFeatureFlags  clutter_feature_get_all            (void);
    +
    ClutterFeatureFlags  clutter_feature_get_all            (void);

    Returns all the supported features.

    +

    +

    Returns :

    TRUE if a feature is available + TRUE if a feature is available
    @@ -226,6 +243,6 @@ + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ClutterAlpha.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ClutterAlpha.html @@ -8,7 +8,7 @@ - + @@ -62,14 +62,14 @@
    Top -  |  - Description -  |  - Object Hierarchy -  |  - Implemented Interfaces -  |  - Properties +  |  + Description +  |  + Object Hierarchy +  |  + Implemented Interfaces +  |  + Properties
    @@ -84,42 +84,77 @@

    Synopsis

    -
                        ClutterAlpha;
    +
    +                    ClutterAlpha;
                         ClutterAlphaClass;
    -gdouble             (*ClutterAlphaFunc)                 (ClutterAlpha *alpha,
    -                                                         gpointer user_data);
    -ClutterAlpha *      clutter_alpha_new                   (void);
    -ClutterAlpha *      clutter_alpha_new_full              (ClutterTimeline *timeline,
    -                                                         gulong mode);
    -ClutterAlpha *      clutter_alpha_new_with_func         (ClutterTimeline *timeline,
    -                                                         ClutterAlphaFunc func,
    -                                                         gpointer data,
    -                                                         GDestroyNotify destroy);
    -void                clutter_alpha_set_timeline          (ClutterAlpha *alpha,
    -                                                         ClutterTimeline *timeline);
    -ClutterTimeline *   clutter_alpha_get_timeline          (ClutterAlpha *alpha);
    -void                clutter_alpha_set_mode              (ClutterAlpha *alpha,
    -                                                         gulong mode);
    -gulong              clutter_alpha_get_mode              (ClutterAlpha *alpha);
    -gdouble             clutter_alpha_get_alpha             (ClutterAlpha *alpha);
    +gdouble             (*ClutterAlphaFunc)                 (ClutterAlpha *alpha,
    +                                                         gpointer user_data);
    +ClutterAlpha *      clutter_alpha_new                   (void);
    +ClutterAlpha *      clutter_alpha_new_full              (ClutterTimeline *timeline,
    +                                                         gulong mode);
    +ClutterAlpha *      clutter_alpha_new_with_func         (ClutterTimeline *timeline,
    +                                                         ClutterAlphaFunc func,
    +                                                         gpointer data,
    +                                                         GDestroyNotify destroy);
    +void                clutter_alpha_set_timeline          (ClutterAlpha *alpha,
    +                                                         ClutterTimeline *timeline);
    +ClutterTimeline *   clutter_alpha_get_timeline          (ClutterAlpha *alpha);
    +void                clutter_alpha_set_mode              (ClutterAlpha *alpha,
    +                                                         gulong mode);
    +gulong              clutter_alpha_get_mode              (ClutterAlpha *alpha);
    +gdouble             clutter_alpha_get_alpha             (ClutterAlpha *alpha);
     
    -void                clutter_alpha_set_func              (ClutterAlpha *alpha,
    -                                                         ClutterAlphaFunc func,
    -                                                         gpointer data,
    -                                                         GDestroyNotify destroy);
    -void                clutter_alpha_set_closure           (ClutterAlpha *alpha,
    -                                                         GClosure *closure);
    +void                clutter_alpha_set_func              (ClutterAlpha *alpha,
    +                                                         ClutterAlphaFunc func,
    +                                                         gpointer data,
    +                                                         GDestroyNotify destroy);
    +void                clutter_alpha_set_closure           (ClutterAlpha *alpha,
    +                                                         GClosure *closure);
     
    -gulong              clutter_alpha_register_closure      (GClosure *closure);
    -gulong              clutter_alpha_register_func         (ClutterAlphaFunc func,
    -                                                         gpointer data);
    +gulong              clutter_alpha_register_closure      (GClosure *closure);
    +gulong              clutter_alpha_register_func         (ClutterAlphaFunc func,
    +                                                         gpointer data);
     

    Object Hierarchy

    -  GObject
    -   +----GInitiallyUnowned
    +  GObject
    +   +----GInitiallyUnowned
              +----ClutterAlpha
     
    @@ -132,9 +167,13 @@

    Properties

    -  "alpha"                    gdouble               : Read
    -  "mode"                     gulong                : Read / Write / Construct
    -  "timeline"                 ClutterTimeline*      : Read / Write
    +  "alpha"                    gdouble               : Read
    +  "mode"                     gulong                : Read / Write / Construct
    +  "timeline"                 ClutterTimeline*      : Read / Write
     
    @@ -189,7 +228,9 @@ ClutterScript which allows to reference a custom alpha function available in the source code. Setting the "function" property is equivalent to calling clutter_alpha_set_func() with the - specified function name. No user data or GDestroyNotify is + specified function name. No user data or GDestroyNotify is available to be passed.

    Example 4. Defining a ClutterAlpha in ClutterScript

    @@ -216,6 +257,8 @@ inside a ClutterScript fragment, see the corresponding section in ClutterAnimation.

    +

    +

    Details

    @@ -226,6 +269,8 @@ ClutterAlpha combines a ClutterTimeline and a function. The contents of the ClutterAlpha structure are private and should only be accessed using the provided API.

    +

    +

    Since 0.2


    @@ -236,16 +281,24 @@

    Base class for ClutterAlpha

    +

    +

    Since 0.2


    ClutterAlphaFunc ()

    -
    gdouble             (*ClutterAlphaFunc)                 (ClutterAlpha *alpha,
    -                                                         gpointer user_data);
    +
    gdouble             (*ClutterAlphaFunc)                 (ClutterAlpha *alpha,
    +                                                         gpointer user_data);

    A function returning a value depending on the position of the ClutterTimeline bound to alpha.

    +

    +

    @@ -272,7 +325,7 @@

    clutter_alpha_new ()

    -
    ClutterAlpha *      clutter_alpha_new                   (void);
    +
    ClutterAlpha *      clutter_alpha_new                   (void);

    Creates a new ClutterAlpha instance. You must set a function to compute the alpha value using clutter_alpha_set_func() and @@ -282,6 +335,8 @@

    You should use the newly created ClutterAlpha instance inside a ClutterBehaviour object.

    +

    +

    @@ -296,14 +351,18 @@

    clutter_alpha_new_full ()

    -
    ClutterAlpha *      clutter_alpha_new_full              (ClutterTimeline *timeline,
    -                                                         gulong mode);
    +
    ClutterAlpha *      clutter_alpha_new_full              (ClutterTimeline *timeline,
    +                                                         gulong mode);

    Creates a new ClutterAlpha instance and sets the timeline and animation mode.

    See also clutter_alpha_set_timeline() and clutter_alpha_set_mode().

    +

    +

    @@ -330,10 +389,14 @@

    clutter_alpha_new_with_func ()

    -
    ClutterAlpha *      clutter_alpha_new_with_func         (ClutterTimeline *timeline,
    -                                                         ClutterAlphaFunc func,
    -                                                         gpointer data,
    -                                                         GDestroyNotify destroy);
    +
    ClutterAlpha *      clutter_alpha_new_with_func         (ClutterTimeline *timeline,
    +                                                         ClutterAlphaFunc func,
    +                                                         gpointer data,
    +                                                         GDestroyNotify destroy);

    Creates a new ClutterAlpha instances and sets the timeline and the alpha function. @@ -343,6 +406,8 @@

    See also clutter_alpha_set_timeline() and clutter_alpha_set_func().

    +

    +

    @@ -358,12 +423,12 @@ - - @@ -379,10 +444,12 @@

    clutter_alpha_set_timeline ()

    -
    void                clutter_alpha_set_timeline          (ClutterAlpha *alpha,
    -                                                         ClutterTimeline *timeline);
    +
    void                clutter_alpha_set_timeline          (ClutterAlpha *alpha,
    +                                                         ClutterTimeline *timeline);

    Binds alpha to timeline.

    +

    +

    data :

    data to pass to the function, or NULL + data to pass to the function, or NULL

    destroy :

    function to call when removing the alpha function, or NULL + function to call when removing the alpha function, or NULL
    @@ -403,9 +470,11 @@

    clutter_alpha_get_timeline ()

    -
    ClutterTimeline *   clutter_alpha_get_timeline          (ClutterAlpha *alpha);
    +
    ClutterTimeline *   clutter_alpha_get_timeline          (ClutterAlpha *alpha);

    Gets the ClutterTimeline bound to alpha.

    +

    +

    @@ -416,7 +485,7 @@ - +

    Returns :

    a ClutterTimeline instance. transfer none. a ClutterTimeline instance. transfer none.
    @@ -425,12 +494,16 @@

    clutter_alpha_set_mode ()

    -
    void                clutter_alpha_set_mode              (ClutterAlpha *alpha,
    -                                                         gulong mode);
    +
    void                clutter_alpha_set_mode              (ClutterAlpha *alpha,
    +                                                         gulong mode);

    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().

    +

    +

    @@ -451,9 +524,13 @@

    clutter_alpha_get_mode ()

    -
    gulong              clutter_alpha_get_mode              (ClutterAlpha *alpha);
    +
    gulong              clutter_alpha_get_mode              (ClutterAlpha *alpha);

    Retrieves the ClutterAnimationMode used by alpha.

    +

    +

    @@ -475,9 +552,13 @@

    clutter_alpha_get_alpha ()

    -
    gdouble             clutter_alpha_get_alpha             (ClutterAlpha *alpha);
    +
    gdouble             clutter_alpha_get_alpha             (ClutterAlpha *alpha);

    Query the current alpha value.

    +

    +

    @@ -499,10 +580,14 @@

    clutter_alpha_set_func ()

    -
    void                clutter_alpha_set_func              (ClutterAlpha *alpha,
    -                                                         ClutterAlphaFunc func,
    -                                                         gpointer data,
    -                                                         GDestroyNotify destroy);
    +
    void                clutter_alpha_set_func              (ClutterAlpha *alpha,
    +                                                         ClutterAlphaFunc func,
    +                                                         gpointer data,
    +                                                         GDestroyNotify destroy);

    Sets the ClutterAlphaFunc function used to compute the alpha value at each frame of the ClutterTimeline @@ -510,6 +595,8 @@

    This function will not register func as a global alpha function.

    +

    +

    @@ -525,7 +612,7 @@ - @@ -540,11 +627,17 @@

    clutter_alpha_set_closure ()

    -
    void                clutter_alpha_set_closure           (ClutterAlpha *alpha,
    -                                                         GClosure *closure);
    -

    -Sets the GClosure used to compute the alpha value at each +

    void                clutter_alpha_set_closure           (ClutterAlpha *alpha,
    +                                                         GClosure *closure);
    +

    +Sets the GClosure used to compute the alpha value at each frame of the ClutterTimeline bound to alpha.

    +

    +

    data :

    user data to be passed to the alpha function, or NULL + user data to be passed to the alpha function, or NULL
    @@ -555,7 +648,9 @@ - @@ -565,22 +660,32 @@

    clutter_alpha_register_closure ()

    -
    gulong              clutter_alpha_register_closure      (GClosure *closure);
    -

    -GClosure variant of clutter_alpha_register_func(). +

    gulong              clutter_alpha_register_closure      (GClosure *closure);
    +

    +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.

    +The logical id is always greater than CLUTTER_ANIMATION_LAST.

    +

    +

    closure :

    A GClosure + A GClosure
    - @@ -596,14 +701,20 @@

    clutter_alpha_register_func ()

    -
    gulong              clutter_alpha_register_func         (ClutterAlphaFunc func,
    -                                                         gpointer data);
    +
    gulong              clutter_alpha_register_func         (ClutterAlphaFunc func,
    +                                                         gpointer data);

    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.

    +The logical id is always greater than CLUTTER_ANIMATION_LAST.

    +

    +

    closure :

    a GClosure + a GClosure
    @@ -614,7 +725,7 @@ - @@ -632,42 +743,52 @@

    Property Details

    The "alpha" property

    -
      "alpha"                    gdouble               : Read
    +
      "alpha"                    gdouble               : Read

    The alpha value as computed by the alpha function. The linear interval is 0.0 to 1.0, but the Alpha allows overshooting by one unit in each direction, so the valid interval is -1.0 to 2.0.

    +

    +

    Allowed values: [-1,2]

    Default value: 0

    -

    Since 0.2

    +

    Since 0.2


    The "mode" property

    -
      "mode"                     gulong                : Read / Write / Construct
    +
      "mode"                     gulong                : Read / Write / Construct

    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 +If CLUTTER_CUSTOM_MODE is used then the function set using clutter_alpha_set_closure() or clutter_alpha_set_func() will be used.

    -

    Since 1.0

    +

    +

    +

    Since 1.0


    The "timeline" property

    -
      "timeline"                 ClutterTimeline*      : Read / Write
    +
      "timeline"                 ClutterTimeline*      : Read / Write

    A ClutterTimeline instance used to drive the alpha function.

    -

    Since 0.2

    +

    +

    +

    Since 0.2

    + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ClutterFlowLayout.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ClutterFlowLayout.html @@ -8,7 +8,7 @@ - + @@ -62,12 +62,12 @@

    data :

    user data to pass to func, or NULL + user data to pass to func, or NULL
    Top -  |  - Description -  |  - Object Hierarchy -  |  - Properties +  |  + Description +  |  + Object Hierarchy +  |  + Properties
    @@ -81,47 +81,80 @@

    Synopsis

    -
    enum                ClutterFlowOrientation;
    +
    +enum                ClutterFlowOrientation;
                         ClutterFlowLayout;
                         ClutterFlowLayoutClass;
    -ClutterLayoutManager * clutter_flow_layout_new          (ClutterFlowOrientation orientation);
    -void                clutter_flow_layout_set_homogeneous (ClutterFlowLayout *layout,
    -                                                         gboolean homogeneous);
    -gboolean            clutter_flow_layout_get_homogeneous (ClutterFlowLayout *layout);
    -void                clutter_flow_layout_set_orientation (ClutterFlowLayout *layout,
    -                                                         ClutterFlowOrientation orientation);
    -ClutterFlowOrientation  clutter_flow_layout_get_orientation
    -                                                        (ClutterFlowLayout *layout);
    +ClutterLayoutManager * clutter_flow_layout_new          (ClutterFlowOrientation orientation);
    +void                clutter_flow_layout_set_homogeneous (ClutterFlowLayout *layout,
    +                                                         gboolean homogeneous);
    +gboolean            clutter_flow_layout_get_homogeneous (ClutterFlowLayout *layout);
    +void                clutter_flow_layout_set_orientation (ClutterFlowLayout *layout,
    +                                                         ClutterFlowOrientation orientation);
    +ClutterFlowOrientation  clutter_flow_layout_get_orientation
    +                                                        (ClutterFlowLayout *layout);
     
    -void                clutter_flow_layout_set_column_spacing
    -                                                        (ClutterFlowLayout *layout,
    -                                                         gfloat spacing);
    -gfloat              clutter_flow_layout_get_column_spacing
    -                                                        (ClutterFlowLayout *layout);
    -void                clutter_flow_layout_set_row_spacing (ClutterFlowLayout *layout,
    -                                                         gfloat spacing);
    -gfloat              clutter_flow_layout_get_row_spacing (ClutterFlowLayout *layout);
    -void                clutter_flow_layout_set_column_width
    -                                                        (ClutterFlowLayout *layout,
    -                                                         gfloat min_width,
    -                                                         gfloat max_width);
    -void                clutter_flow_layout_get_column_width
    -                                                        (ClutterFlowLayout *layout,
    -                                                         gfloat *min_width,
    -                                                         gfloat *max_width);
    -void                clutter_flow_layout_set_row_height  (ClutterFlowLayout *layout,
    -                                                         gfloat min_height,
    -                                                         gfloat max_height);
    -void                clutter_flow_layout_get_row_height  (ClutterFlowLayout *layout,
    -                                                         gfloat *min_height,
    -                                                         gfloat *max_height);
    +void                clutter_flow_layout_set_column_spacing
    +                                                        (ClutterFlowLayout *layout,
    +                                                         gfloat spacing);
    +gfloat              clutter_flow_layout_get_column_spacing
    +                                                        (ClutterFlowLayout *layout);
    +void                clutter_flow_layout_set_row_spacing (ClutterFlowLayout *layout,
    +                                                         gfloat spacing);
    +gfloat              clutter_flow_layout_get_row_spacing (ClutterFlowLayout *layout);
    +void                clutter_flow_layout_set_column_width
    +                                                        (ClutterFlowLayout *layout,
    +                                                         gfloat min_width,
    +                                                         gfloat max_width);
    +void                clutter_flow_layout_get_column_width
    +                                                        (ClutterFlowLayout *layout,
    +                                                         gfloat *min_width,
    +                                                         gfloat *max_width);
    +void                clutter_flow_layout_set_row_height  (ClutterFlowLayout *layout,
    +                                                         gfloat min_height,
    +                                                         gfloat max_height);
    +void                clutter_flow_layout_get_row_height  (ClutterFlowLayout *layout,
    +                                                         gfloat *min_height,
    +                                                         gfloat *max_height);
     

    Object Hierarchy

    -  GObject
    -   +----GInitiallyUnowned
    +  GObject
    +   +----GInitiallyUnowned
              +----ClutterLayoutManager
                    +----ClutterFlowLayout
     
    @@ -129,14 +162,28 @@

    Properties

    -  "column-spacing"           gfloat                : Read / Write
    -  "homogeneous"              gboolean              : Read / Write
    -  "max-column-width"         gfloat                : Read / Write
    -  "max-row-height"           gfloat                : Read / Write
    -  "min-column-width"         gfloat                : Read / Write
    -  "min-row-height"           gfloat                : Read / Write
    -  "orientation"              ClutterFlowOrientation  : Read / Write / Construct
    -  "row-spacing"              gfloat                : Read / Write
    +  "column-spacing"           gfloat                : Read / Write
    +  "homogeneous"              gboolean              : Read / Write
    +  "max-column-width"         gfloat                : Read / Write
    +  "max-row-height"           gfloat                : Read / Write
    +  "min-column-width"         gfloat                : Read / Write
    +  "min-row-height"           gfloat                : Read / Write
    +  "orientation"              ClutterFlowOrientation  : Read / Write / Construct
    +  "row-spacing"              gfloat                : Read / Write
     
    @@ -158,8 +205,8 @@ the amount of columns and rows;

  • each line (either column or row) in reflowing will have the size of the biggest cell on that line; if the - "homogeneous" property is set to FALSE the actor - will be allocated within that area, and if set to TRUE instead the + "homogeneous" property is set to FALSE the actor + will be allocated within that area, and if set to TRUE instead the actor will be given exactly that area;

  • the size of the columns or rows can be controlled for both minimum and maximum; the spacing can also be controlled @@ -174,7 +221,7 @@

    The image shows a ClutterFlowLayout with the "orientation" propert set to - CLUTTER_FLOW_HORIZONTAL.

    + CLUTTER_FLOW_HORIZONTAL.

    Horizontal flow layout
  • @@ -187,7 +234,7 @@

    The image shows a ClutterFlowLayout with the "orientation" propert set to - CLUTTER_FLOW_VERTICAL.

    + CLUTTER_FLOW_VERTICAL.

    Vertical flow layout
    @@ -195,6 +242,8 @@

    ClutterFlowLayout is available since Clutter 1.2

    +

    +

    Details

    @@ -208,17 +257,19 @@

    The direction of the arrangement of the children inside a ClutterFlowLayout

    +

    +

    - + - + @@ -234,6 +285,8 @@

    The ClutterFlowLayout structure contains only private data and should be accessed using the provided API

    +

    +

    Since 1.2


    @@ -245,14 +298,18 @@

    The ClutterFlowLayoutClass structure contains only private data and should be accessed using the provided API

    +

    +

    Since 1.2


    clutter_flow_layout_new ()

    -
    ClutterLayoutManager * clutter_flow_layout_new          (ClutterFlowOrientation orientation);
    +
    ClutterLayoutManager * clutter_flow_layout_new          (ClutterFlowOrientation orientation);

    Creates a new ClutterFlowLayout with the given orientation

    +

    +

    CLUTTER_FLOW_HORIZONTAL

    CLUTTER_FLOW_HORIZONTAL

    Arrange the children of the flow layout horizontally first

    CLUTTER_FLOW_VERTICAL

    CLUTTER_FLOW_VERTICAL

    Arrange the children of the flow layout vertically first
    @@ -274,11 +331,15 @@

    clutter_flow_layout_set_homogeneous ()

    -
    void                clutter_flow_layout_set_homogeneous (ClutterFlowLayout *layout,
    -                                                         gboolean homogeneous);
    +
    void                clutter_flow_layout_set_homogeneous (ClutterFlowLayout *layout,
    +                                                         gboolean homogeneous);

    Sets whether the layout should allocate the same space for each child

    +

    +

    @@ -299,9 +360,13 @@

    clutter_flow_layout_get_homogeneous ()

    -
    gboolean            clutter_flow_layout_get_homogeneous (ClutterFlowLayout *layout);
    +
    gboolean            clutter_flow_layout_get_homogeneous (ClutterFlowLayout *layout);

    Retrieves whether the layout is homogeneous

    +

    +

    @@ -312,7 +377,7 @@ - @@ -323,8 +388,8 @@

    clutter_flow_layout_set_orientation ()

    -
    void                clutter_flow_layout_set_orientation (ClutterFlowLayout *layout,
    -                                                         ClutterFlowOrientation orientation);
    +
    void                clutter_flow_layout_set_orientation (ClutterFlowLayout *layout,
    +                                                         ClutterFlowOrientation orientation);

    Sets the orientation of the flow layout

    @@ -332,6 +397,8 @@ The orientation controls the direction used to allocate the children: either horizontally or vertically. The orientation also controls the direction of the overflowing

    +

    +

    Returns :

    TRUE if the ClutterFlowLayout is homogeneous + TRUE if the ClutterFlowLayout is homogeneous
    @@ -352,10 +419,12 @@

    clutter_flow_layout_get_orientation ()

    -
    ClutterFlowOrientation  clutter_flow_layout_get_orientation
    -                                                        (ClutterFlowLayout *layout);
    +
    ClutterFlowOrientation  clutter_flow_layout_get_orientation
    +                                                        (ClutterFlowLayout *layout);

    Retrieves the orientation of the layout

    +

    +

    @@ -377,11 +446,15 @@

    clutter_flow_layout_set_column_spacing ()

    -
    void                clutter_flow_layout_set_column_spacing
    -                                                        (ClutterFlowLayout *layout,
    -                                                         gfloat spacing);
    +
    void                clutter_flow_layout_set_column_spacing
    +                                                        (ClutterFlowLayout *layout,
    +                                                         gfloat spacing);

    Sets the space between columns, in pixels

    +

    +

    @@ -402,10 +475,14 @@

    clutter_flow_layout_get_column_spacing ()

    -
    gfloat              clutter_flow_layout_get_column_spacing
    -                                                        (ClutterFlowLayout *layout);
    +
    gfloat              clutter_flow_layout_get_column_spacing
    +                                                        (ClutterFlowLayout *layout);

    Retrieves the spacing between columns

    +

    +

    @@ -428,10 +505,14 @@

    clutter_flow_layout_set_row_spacing ()

    -
    void                clutter_flow_layout_set_row_spacing (ClutterFlowLayout *layout,
    -                                                         gfloat spacing);
    +
    void                clutter_flow_layout_set_row_spacing (ClutterFlowLayout *layout,
    +                                                         gfloat spacing);

    Sets the spacing between rows, in pixels

    +

    +

    @@ -452,9 +533,13 @@

    clutter_flow_layout_get_row_spacing ()

    -
    gfloat              clutter_flow_layout_get_row_spacing (ClutterFlowLayout *layout);
    +
    gfloat              clutter_flow_layout_get_row_spacing (ClutterFlowLayout *layout);

    Retrieves the spacing between rows

    +

    +

    @@ -477,12 +562,18 @@

    clutter_flow_layout_set_column_width ()

    -
    void                clutter_flow_layout_set_column_width
    -                                                        (ClutterFlowLayout *layout,
    -                                                         gfloat min_width,
    -                                                         gfloat max_width);
    +
    void                clutter_flow_layout_set_column_width
    +                                                        (ClutterFlowLayout *layout,
    +                                                         gfloat min_width,
    +                                                         gfloat max_width);

    Sets the minimum and maximum widths that a column can have

    +

    +

    @@ -508,12 +599,18 @@

    clutter_flow_layout_get_column_width ()

    -
    void                clutter_flow_layout_get_column_width
    -                                                        (ClutterFlowLayout *layout,
    -                                                         gfloat *min_width,
    -                                                         gfloat *max_width);
    +
    void                clutter_flow_layout_get_column_width
    +                                                        (ClutterFlowLayout *layout,
    +                                                         gfloat *min_width,
    +                                                         gfloat *max_width);

    Retrieves the minimum and maximum column widths

    +

    +

    @@ -524,11 +621,11 @@ - + - +

    min_width :

    return location for the minimum column width, or NULL. out. return location for the minimum column width, or NULL. out.

    max_width :

    return location for the maximum column width, or NULL. out. return location for the maximum column width, or NULL. out.
    @@ -537,11 +634,17 @@

    clutter_flow_layout_set_row_height ()

    -
    void                clutter_flow_layout_set_row_height  (ClutterFlowLayout *layout,
    -                                                         gfloat min_height,
    -                                                         gfloat max_height);
    +
    void                clutter_flow_layout_set_row_height  (ClutterFlowLayout *layout,
    +                                                         gfloat min_height,
    +                                                         gfloat max_height);

    Sets the minimum and maximum heights that a row can have

    +

    +

    @@ -567,11 +670,17 @@

    clutter_flow_layout_get_row_height ()

    -
    void                clutter_flow_layout_get_row_height  (ClutterFlowLayout *layout,
    -                                                         gfloat *min_height,
    -                                                         gfloat *max_height);
    +
    void                clutter_flow_layout_get_row_height  (ClutterFlowLayout *layout,
    +                                                         gfloat *min_height,
    +                                                         gfloat *max_height);

    Retrieves the minimum and maximum row heights

    +

    +

    @@ -582,11 +691,11 @@ - + - +

    min_height :

    return location for the minimum row height, or NULL. out. return location for the minimum row height, or NULL. out.

    max_height :

    return location for the maximum row height, or NULL. out. return location for the maximum row height, or NULL. out.
    @@ -597,96 +706,126 @@

    Property Details

    The "column-spacing" property

    -
      "column-spacing"           gfloat                : Read / Write
    +
      "column-spacing"           gfloat                : Read / Write

    The spacing between columns, in pixels; the value of this property is honoured by horizontal non-overflowing layouts and by vertical overflowing layouts

    +

    +

    Allowed values: >= 0

    Default value: 0

    -

    Since 1.2

    +

    Since 1.2


    The "homogeneous" property

    -
      "homogeneous"              gboolean              : Read / Write
    +
      "homogeneous"              gboolean              : Read / Write

    Whether each child inside the ClutterFlowLayout should receive the same allocation

    +

    +

    Default value: FALSE

    -

    Since 1.2

    +

    Since 1.2


    The "max-column-width" property

    -
      "max-column-width"         gfloat                : Read / Write
    +
      "max-column-width"         gfloat                : Read / Write

    Maximum width for each column in the layout, in pixels. If set to -1 the width will be the maximum child width

    +

    +

    Allowed values: >= -1

    Default value: -1

    -

    Since 1.2

    +

    Since 1.2


    The "max-row-height" property

    -
      "max-row-height"           gfloat                : Read / Write
    +
      "max-row-height"           gfloat                : Read / Write

    Maximum height for each row in the layout, in pixels. If set to -1 the width will be the maximum child height

    +

    +

    Allowed values: >= -1

    Default value: -1

    -

    Since 1.2

    +

    Since 1.2


    The "min-column-width" property

    -
      "min-column-width"         gfloat                : Read / Write
    +
      "min-column-width"         gfloat                : Read / Write

    Minimum width for each column in the layout, in pixels

    +

    +

    Allowed values: >= 0

    Default value: 0

    -

    Since 1.2

    +

    Since 1.2


    The "min-row-height" property

    -
      "min-row-height"           gfloat                : Read / Write
    +
      "min-row-height"           gfloat                : Read / Write

    Minimum height for each row in the layout, in pixels

    +

    +

    Allowed values: >= 0

    Default value: 0

    -

    Since 1.2

    +

    Since 1.2


    The "orientation" property

    -
      "orientation"              ClutterFlowOrientation  : Read / Write / Construct
    +
      "orientation"              ClutterFlowOrientation  : Read / Write / Construct

    The orientation of the ClutterFlowLayout. The children of the layout will be layed out following the orientation.

    This property also controls the overflowing directions

    +

    +

    Default value: CLUTTER_FLOW_HORIZONTAL

    -

    Since 1.2

    +

    Since 1.2


    The "row-spacing" property

    -
      "row-spacing"              gfloat                : Read / Write
    +
      "row-spacing"              gfloat                : Read / Write

    The spacing between rows, in pixels; the value of this property is honoured by vertical non-overflowing layouts and by horizontal overflowing layouts

    +

    +

    Allowed values: >= 0

    Default value: 0

    -

    Since 1.2

    +

    Since 1.2

    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ClutterBehaviourEllipse.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ClutterBehaviourEllipse.html @@ -8,7 +8,7 @@ - + @@ -62,14 +62,14 @@ Top -  |  - Description -  |  - Object Hierarchy -  |  - Implemented Interfaces -  |  - Properties +  |  + Description +  |  + Object Hierarchy +  |  + Implemented Interfaces +  |  + Properties
    @@ -83,68 +83,123 @@

    Synopsis

    -
                        ClutterBehaviourEllipse;
    +
    +                    ClutterBehaviourEllipse;
                         ClutterBehaviourEllipseClass;
    -ClutterBehaviour *  clutter_behaviour_ellipse_new       (ClutterAlpha *alpha,
    -                                                         gint x,
    -                                                         gint y,
    -                                                         gint width,
    -                                                         gint height,
    -                                                         ClutterRotateDirection direction,
    -                                                         gdouble start,
    -                                                         gdouble end);
    -void                clutter_behaviour_ellipse_set_center
    -                                                        (ClutterBehaviourEllipse *self,
    -                                                         gint x,
    -                                                         gint y);
    -void                clutter_behaviour_ellipse_get_center
    -                                                        (ClutterBehaviourEllipse *self,
    -                                                         gint *x,
    -                                                         gint *y);
    -void                clutter_behaviour_ellipse_set_angle_start
    -                                                        (ClutterBehaviourEllipse *self,
    -                                                         gdouble angle_start);
    -gdouble             clutter_behaviour_ellipse_get_angle_start
    -                                                        (ClutterBehaviourEllipse *self);
    -void                clutter_behaviour_ellipse_set_angle_end
    -                                                        (ClutterBehaviourEllipse *self,
    -                                                         gdouble angle_end);
    -gdouble             clutter_behaviour_ellipse_get_angle_end
    -                                                        (ClutterBehaviourEllipse *self);
    -void                clutter_behaviour_ellipse_set_angle_tilt
    -                                                        (ClutterBehaviourEllipse *self,
    -                                                         ClutterRotateAxis axis,
    -                                                         gdouble angle_tilt);
    -gdouble             clutter_behaviour_ellipse_get_angle_tilt
    -                                                        (ClutterBehaviourEllipse *self,
    -                                                         ClutterRotateAxis axis);
    -void                clutter_behaviour_ellipse_set_height
    -                                                        (ClutterBehaviourEllipse *self,
    -                                                         gint height);
    -gint                clutter_behaviour_ellipse_get_height
    -                                                        (ClutterBehaviourEllipse *self);
    -void                clutter_behaviour_ellipse_set_width (ClutterBehaviourEllipse *self,
    -                                                         gint width);
    -gint                clutter_behaviour_ellipse_get_width (ClutterBehaviourEllipse *self);
    -void                clutter_behaviour_ellipse_set_tilt  (ClutterBehaviourEllipse *self,
    -                                                         gdouble angle_tilt_x,
    -                                                         gdouble angle_tilt_y,
    -                                                         gdouble angle_tilt_z);
    -void                clutter_behaviour_ellipse_get_tilt  (ClutterBehaviourEllipse *self,
    -                                                         gdouble *angle_tilt_x,
    -                                                         gdouble *angle_tilt_y,
    -                                                         gdouble *angle_tilt_z);
    -void                clutter_behaviour_ellipse_set_direction
    -                                                        (ClutterBehaviourEllipse *self,
    -                                                         ClutterRotateDirection direction);
    -ClutterRotateDirection  clutter_behaviour_ellipse_get_direction
    -                                                        (ClutterBehaviourEllipse *self);
    +ClutterBehaviour *  clutter_behaviour_ellipse_new       (ClutterAlpha *alpha,
    +                                                         gint x,
    +                                                         gint y,
    +                                                         gint width,
    +                                                         gint height,
    +                                                         ClutterRotateDirection direction,
    +                                                         gdouble start,
    +                                                         gdouble end);
    +void                clutter_behaviour_ellipse_set_center
    +                                                        (ClutterBehaviourEllipse *self,
    +                                                         gint x,
    +                                                         gint y);
    +void                clutter_behaviour_ellipse_get_center
    +                                                        (ClutterBehaviourEllipse *self,
    +                                                         gint *x,
    +                                                         gint *y);
    +void                clutter_behaviour_ellipse_set_angle_start
    +                                                        (ClutterBehaviourEllipse *self,
    +                                                         gdouble angle_start);
    +gdouble             clutter_behaviour_ellipse_get_angle_start
    +                                                        (ClutterBehaviourEllipse *self);
    +void                clutter_behaviour_ellipse_set_angle_end
    +                                                        (ClutterBehaviourEllipse *self,
    +                                                         gdouble angle_end);
    +gdouble             clutter_behaviour_ellipse_get_angle_end
    +                                                        (ClutterBehaviourEllipse *self);
    +void                clutter_behaviour_ellipse_set_angle_tilt
    +                                                        (ClutterBehaviourEllipse *self,
    +                                                         ClutterRotateAxis axis,
    +                                                         gdouble angle_tilt);
    +gdouble             clutter_behaviour_ellipse_get_angle_tilt
    +                                                        (ClutterBehaviourEllipse *self,
    +                                                         ClutterRotateAxis axis);
    +void                clutter_behaviour_ellipse_set_height
    +                                                        (ClutterBehaviourEllipse *self,
    +                                                         gint height);
    +gint                clutter_behaviour_ellipse_get_height
    +                                                        (ClutterBehaviourEllipse *self);
    +void                clutter_behaviour_ellipse_set_width (ClutterBehaviourEllipse *self,
    +                                                         gint width);
    +gint                clutter_behaviour_ellipse_get_width (ClutterBehaviourEllipse *self);
    +void                clutter_behaviour_ellipse_set_tilt  (ClutterBehaviourEllipse *self,
    +                                                         gdouble angle_tilt_x,
    +                                                         gdouble angle_tilt_y,
    +                                                         gdouble angle_tilt_z);
    +void                clutter_behaviour_ellipse_get_tilt  (ClutterBehaviourEllipse *self,
    +                                                         gdouble *angle_tilt_x,
    +                                                         gdouble *angle_tilt_y,
    +                                                         gdouble *angle_tilt_z);
    +void                clutter_behaviour_ellipse_set_direction
    +                                                        (ClutterBehaviourEllipse *self,
    +                                                         ClutterRotateDirection direction);
    +ClutterRotateDirection  clutter_behaviour_ellipse_get_direction
    +                                                        (ClutterBehaviourEllipse *self);
     

    Object Hierarchy

    -  GObject
    +  GObject
        +----ClutterBehaviour
              +----ClutterBehaviourEllipse
     
    @@ -158,15 +213,29 @@

    Properties

    -  "angle-end"                gdouble               : Read / Write
    -  "angle-start"              gdouble               : Read / Write
    -  "angle-tilt-x"             gdouble               : Read / Write
    -  "angle-tilt-y"             gdouble               : Read / Write
    -  "angle-tilt-z"             gdouble               : Read / Write
    -  "center"                   ClutterKnot*          : Read / Write
    -  "direction"                ClutterRotateDirection  : Read / Write
    -  "height"                   gint                  : Read / Write
    -  "width"                    gint                  : Read / Write
    +  "angle-end"                gdouble               : Read / Write
    +  "angle-start"              gdouble               : Read / Write
    +  "angle-tilt-x"             gdouble               : Read / Write
    +  "angle-tilt-y"             gdouble               : Read / Write
    +  "angle-tilt-z"             gdouble               : Read / Write
    +  "center"                   ClutterKnot*          : Read / Write
    +  "direction"                ClutterRotateDirection  : Read / Write
    +  "height"                   gint                  : Read / Write
    +  "width"                    gint                  : Read / Write
     
    @@ -183,6 +252,8 @@ behaviour will update the actor's position and depth and set them to what is dictated by the ellipses initial position.

    +

    +

    Details

    @@ -192,6 +263,8 @@

    The ClutterBehaviourEllipse struct contains only private data and should be accessed using the provided API

    +

    +

    Since 0.4


    @@ -202,19 +275,33 @@

    The ClutterBehaviourEllipseClass struct contains only private data

    +

    +

    Since 0.4


    clutter_behaviour_ellipse_new ()

    -
    ClutterBehaviour *  clutter_behaviour_ellipse_new       (ClutterAlpha *alpha,
    -                                                         gint x,
    -                                                         gint y,
    -                                                         gint width,
    -                                                         gint height,
    -                                                         ClutterRotateDirection direction,
    -                                                         gdouble start,
    -                                                         gdouble end);
    +
    ClutterBehaviour *  clutter_behaviour_ellipse_new       (ClutterAlpha *alpha,
    +                                                         gint x,
    +                                                         gint y,
    +                                                         gint width,
    +                                                         gint height,
    +                                                         ClutterRotateDirection direction,
    +                                                         gdouble start,
    +                                                         gdouble end);

    Creates a behaviour that drives actors along an elliptical path with given center, width and height; the movement starts at start @@ -222,12 +309,14 @@ 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.

    +

    +

    - @@ -278,12 +367,18 @@

    clutter_behaviour_ellipse_set_center ()

    -
    void                clutter_behaviour_ellipse_set_center
    -                                                        (ClutterBehaviourEllipse *self,
    -                                                         gint x,
    -                                                         gint y);
    +
    void                clutter_behaviour_ellipse_set_center
    +                                                        (ClutterBehaviourEllipse *self,
    +                                                         gint x,
    +                                                         gint y);

    Sets the center of the elliptical path to the point represented by knot.

    +

    +

    alpha :

    a ClutterAlpha, or NULL + a ClutterAlpha, or NULL
    @@ -309,12 +404,18 @@

    clutter_behaviour_ellipse_get_center ()

    -
    void                clutter_behaviour_ellipse_get_center
    -                                                        (ClutterBehaviourEllipse *self,
    -                                                         gint *x,
    -                                                         gint *y);
    +
    void                clutter_behaviour_ellipse_get_center
    +                                                        (ClutterBehaviourEllipse *self,
    +                                                         gint *x,
    +                                                         gint *y);

    Gets the center of the elliptical path path.

    +

    +

    @@ -325,12 +426,12 @@ - - @@ -340,12 +441,16 @@

    clutter_behaviour_ellipse_set_angle_start ()

    -
    void                clutter_behaviour_ellipse_set_angle_start
    -                                                        (ClutterBehaviourEllipse *self,
    -                                                         gdouble angle_start);
    +
    void                clutter_behaviour_ellipse_set_angle_start
    +                                                        (ClutterBehaviourEllipse *self,
    +                                                         gdouble angle_start);

    Sets the angle at which movement starts; angles >= 360 degress get clamped to the canonical interval <0, 360).

    +

    +

    x :

    return location for the X coordinate of the center, or NULL + return location for the X coordinate of the center, or NULL

    y :

    return location for the Y coordinate of the center, or NULL + return location for the Y coordinate of the center, or NULL
    @@ -366,10 +471,14 @@

    clutter_behaviour_ellipse_get_angle_start ()

    -
    gdouble             clutter_behaviour_ellipse_get_angle_start
    -                                                        (ClutterBehaviourEllipse *self);
    +
    gdouble             clutter_behaviour_ellipse_get_angle_start
    +                                                        (ClutterBehaviourEllipse *self);

    Gets the angle at which movements starts.

    +

    +

    @@ -391,12 +500,16 @@

    clutter_behaviour_ellipse_set_angle_end ()

    -
    void                clutter_behaviour_ellipse_set_angle_end
    -                                                        (ClutterBehaviourEllipse *self,
    -                                                         gdouble angle_end);
    +
    void                clutter_behaviour_ellipse_set_angle_end
    +                                                        (ClutterBehaviourEllipse *self,
    +                                                         gdouble angle_end);

    Sets the angle at which movement ends; angles >= 360 degress get clamped to the canonical interval <0, 360).

    +

    +

    @@ -417,10 +530,14 @@

    clutter_behaviour_ellipse_get_angle_end ()

    -
    gdouble             clutter_behaviour_ellipse_get_angle_end
    -                                                        (ClutterBehaviourEllipse *self);
    +
    gdouble             clutter_behaviour_ellipse_get_angle_end
    +                                                        (ClutterBehaviourEllipse *self);

    Gets the at which movements ends.

    +

    +

    @@ -442,12 +559,16 @@

    clutter_behaviour_ellipse_set_angle_tilt ()

    -
    void                clutter_behaviour_ellipse_set_angle_tilt
    -                                                        (ClutterBehaviourEllipse *self,
    -                                                         ClutterRotateAxis axis,
    -                                                         gdouble angle_tilt);
    +
    void                clutter_behaviour_ellipse_set_angle_tilt
    +                                                        (ClutterBehaviourEllipse *self,
    +                                                         ClutterRotateAxis axis,
    +                                                         gdouble angle_tilt);

    Sets the angle at which the ellipse should be tilted around it's center.

    +

    +

    @@ -474,11 +595,15 @@

    clutter_behaviour_ellipse_get_angle_tilt ()

    -
    gdouble             clutter_behaviour_ellipse_get_angle_tilt
    -                                                        (ClutterBehaviourEllipse *self,
    -                                                         ClutterRotateAxis axis);
    +
    gdouble             clutter_behaviour_ellipse_get_angle_tilt
    +                                                        (ClutterBehaviourEllipse *self,
    +                                                         ClutterRotateAxis axis);

    Gets the tilt of the ellipse around the center in the given axis.

    +

    +

    @@ -505,11 +630,15 @@

    clutter_behaviour_ellipse_set_height ()

    -
    void                clutter_behaviour_ellipse_set_height
    -                                                        (ClutterBehaviourEllipse *self,
    -                                                         gint height);
    +
    void                clutter_behaviour_ellipse_set_height
    +                                                        (ClutterBehaviourEllipse *self,
    +                                                         gint height);

    Sets the height of the elliptical path.

    +

    +

    @@ -530,10 +659,14 @@

    clutter_behaviour_ellipse_get_height ()

    -
    gint                clutter_behaviour_ellipse_get_height
    -                                                        (ClutterBehaviourEllipse *self);
    +
    gint                clutter_behaviour_ellipse_get_height
    +                                                        (ClutterBehaviourEllipse *self);

    Gets the height of the elliptical path.

    +

    +

    @@ -555,10 +688,14 @@

    clutter_behaviour_ellipse_set_width ()

    -
    void                clutter_behaviour_ellipse_set_width (ClutterBehaviourEllipse *self,
    -                                                         gint width);
    +
    void                clutter_behaviour_ellipse_set_width (ClutterBehaviourEllipse *self,
    +                                                         gint width);

    Sets the width of the elliptical path.

    +

    +

    @@ -579,9 +716,13 @@

    clutter_behaviour_ellipse_get_width ()

    -
    gint                clutter_behaviour_ellipse_get_width (ClutterBehaviourEllipse *self);
    +
    gint                clutter_behaviour_ellipse_get_width (ClutterBehaviourEllipse *self);

    Gets the width of the elliptical path.

    +

    +

    @@ -603,12 +744,20 @@

    clutter_behaviour_ellipse_set_tilt ()

    -
    void                clutter_behaviour_ellipse_set_tilt  (ClutterBehaviourEllipse *self,
    -                                                         gdouble angle_tilt_x,
    -                                                         gdouble angle_tilt_y,
    -                                                         gdouble angle_tilt_z);
    +
    void                clutter_behaviour_ellipse_set_tilt  (ClutterBehaviourEllipse *self,
    +                                                         gdouble angle_tilt_x,
    +                                                         gdouble angle_tilt_y,
    +                                                         gdouble angle_tilt_z);

    Sets the angles at which the ellipse should be tilted around it's center.

    +

    +

    @@ -639,12 +788,20 @@

    clutter_behaviour_ellipse_get_tilt ()

    -
    void                clutter_behaviour_ellipse_get_tilt  (ClutterBehaviourEllipse *self,
    -                                                         gdouble *angle_tilt_x,
    -                                                         gdouble *angle_tilt_y,
    -                                                         gdouble *angle_tilt_z);
    +
    void                clutter_behaviour_ellipse_get_tilt  (ClutterBehaviourEllipse *self,
    +                                                         gdouble *angle_tilt_x,
    +                                                         gdouble *angle_tilt_y,
    +                                                         gdouble *angle_tilt_z);

    Gets the tilt of the ellipse around the center in Y axis.

    +

    +

    @@ -655,17 +812,17 @@ - - - @@ -675,11 +832,13 @@

    clutter_behaviour_ellipse_set_direction ()

    -
    void                clutter_behaviour_ellipse_set_direction
    -                                                        (ClutterBehaviourEllipse *self,
    -                                                         ClutterRotateDirection direction);
    +
    void                clutter_behaviour_ellipse_set_direction
    +                                                        (ClutterBehaviourEllipse *self,
    +                                                         ClutterRotateDirection direction);

    Sets the rotation direction used by the ellipse behaviour.

    +

    +

    angle_tilt_x :

    return location for tilt angle on the X axis, or NULL. + return location for tilt angle on the X axis, or NULL.

    angle_tilt_y :

    return location for tilt angle on the Y axis, or NULL. + return location for tilt angle on the Y axis, or NULL.

    angle_tilt_z :

    return location for tilt angle on the Z axis, or NULL. + return location for tilt angle on the Z axis, or NULL.
    @@ -700,10 +859,12 @@

    clutter_behaviour_ellipse_get_direction ()

    -
    ClutterRotateDirection  clutter_behaviour_ellipse_get_direction
    -                                                        (ClutterBehaviourEllipse *self);
    +
    ClutterRotateDirection  clutter_behaviour_ellipse_get_direction
    +                                                        (ClutterBehaviourEllipse *self);

    Retrieves the ClutterRotateDirection used by the ellipse behaviour.

    +

    +

    @@ -727,94 +888,126 @@

    Property Details

    The "angle-end" property

    -
      "angle-end"                gdouble               : Read / Write
    +
      "angle-end"                gdouble               : Read / Write

    The final angle to where the rotation should end.

    +

    +

    Allowed values: [0,360]

    Default value: 0

    -

    Since 0.4

    +

    Since 0.4


    The "angle-start" property

    -
      "angle-start"              gdouble               : Read / Write
    +
      "angle-start"              gdouble               : Read / Write

    The initial angle from where the rotation should start.

    +

    +

    Allowed values: [0,360]

    Default value: 0

    -

    Since 0.4

    +

    Since 0.4


    The "angle-tilt-x" property

    -
      "angle-tilt-x"             gdouble               : Read / Write
    +
      "angle-tilt-x"             gdouble               : Read / Write

    The tilt angle for the rotation around center in X axis

    +

    +

    Allowed values: [0,360]

    Default value: 360

    -

    Since 0.4

    +

    Since 0.4


    The "angle-tilt-y" property

    -
      "angle-tilt-y"             gdouble               : Read / Write
    +
      "angle-tilt-y"             gdouble               : Read / Write

    The tilt angle for the rotation around center in Y axis

    +

    +

    Allowed values: [0,360]

    Default value: 360

    -

    Since 0.4

    +

    Since 0.4


    The "angle-tilt-z" property

    -
      "angle-tilt-z"             gdouble               : Read / Write
    +
      "angle-tilt-z"             gdouble               : Read / Write

    The tilt angle for the rotation on the Z axis

    +

    +

    Allowed values: [0,360]

    Default value: 360

    -

    Since 0.4

    +

    Since 0.4


    The "center" property

    -
      "center"                   ClutterKnot*          : Read / Write
    +
      "center"                   ClutterKnot*          : Read / Write

    The center of the ellipse.

    -

    Since 0.4

    +

    +

    +

    Since 0.4


    The "direction" property

    -
      "direction"                ClutterRotateDirection  : Read / Write
    +
      "direction"                ClutterRotateDirection  : Read / Write

    The direction of the rotation.

    +

    +

    Default value: CLUTTER_ROTATE_CW

    -

    Since 0.4

    +

    Since 0.4


    The "height" property

    -
      "height"                   gint                  : Read / Write
    +
      "height"                   gint                  : Read / Write

    Height of the ellipse, in pixels

    +

    +

    Allowed values: >= 0

    Default value: 50

    -

    Since 0.4

    +

    Since 0.4


    The "width" property

    -
      "width"                    gint                  : Read / Write
    +
      "width"                    gint                  : Read / Write

    Width of the ellipse, in pixels

    +

    +

    Allowed values: >= 0

    Default value: 100

    -

    Since 0.4

    +

    Since 0.4

    + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ix08.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ix08.html @@ -8,7 +8,7 @@ - + @@ -52,46 +52,20 @@ -
    - + - - - +

    -Index of new symbols in 1.2

    -

    A

    +Index of new symbols in 1.2
    +
    + + + + + + + + + + + + + +
    +
    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ix06.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ix06.html @@ -8,7 +8,7 @@ - + @@ -52,50 +52,20 @@ - - + - - - +

    -Index of new symbols in 0.8

    -

    A

    +Index of new symbols in 0.8
    +
    +
    +

    A

    +
    ClutterActor::paint
    ClutterActor::realize
    @@ -172,13 +142,21 @@
    clutter_alpha_set_closure
    -

    B

    +
    +
    +
    +

    B

    +
    clutter_backend_get_font_options
    clutter_backend_set_font_options
    -

    C

    -
    ClutterChildMeta
    +
    +
    +
    +

    C

    +
    +
    ClutterChildMeta
    ClutterChildMeta:actor
    @@ -206,15 +184,27 @@
    clutter_container_get_child_meta
    -

    E

    +
    +
    +
    +

    E

    +
    clutter_event_get_stage
    -

    F

    +
    +
    +
    +

    F

    +
    clutter_frame_source_add
    clutter_frame_source_add_full
    -

    G

    +
    +
    +
    +

    G

    +
    clutter_get_input_device_for_id
    ClutterGLXTexturePixmap
    @@ -231,20 +221,36 @@
    clutter_grab_pointer_for_device
    -

    M

    +
    +
    +
    +

    M

    +
    clutter_model_iter_copy
    -

    P

    +
    +
    +
    +

    P

    +
    ClutterParamSpecFixed
    clutter_param_spec_fixed
    -
    CLUTTER_PRIORITY_REDRAW
    +
    CLUTTER_PRIORITY_REDRAW
    -

    R

    +
    +
    +
    +

    R

    +
    ClutterRequestMode
    -

    S

    +
    +
    +
    +

    S

    +
    clutter_score_append_at_marker
    clutter_script_add_search_paths
    @@ -279,7 +285,11 @@
    clutter_stage_queue_redraw
    -

    T

    +
    +
    +
    +

    T

    +
    ClutterTextureQuality
    clutter_texture_get_cogl_texture
    @@ -314,10 +324,18 @@
    clutter_timeline_remove_marker
    -

    U

    +
    +
    +
    +

    U

    +
    clutter_ungrab_pointer_for_device
    -

    V

    +
    +
    +
    +

    V

    +
    clutter_value_get_fixed
    clutter_value_get_shader_float
    @@ -328,9 +346,9 @@
    clutter_value_get_units
    -
    CLUTTER_VALUE_HOLDS_FIXED
    +
    CLUTTER_VALUE_HOLDS_FIXED
    -
    CLUTTER_VALUE_HOLDS_UNITS
    +
    CLUTTER_VALUE_HOLDS_UNITS
    clutter_value_set_fixed
    @@ -342,7 +360,11 @@
    clutter_value_set_units
    -

    W

    +
    +
    +
    +

    W

    +
    clutter_win32_disable_event_retrieval
    clutter_win32_get_stage_from_window
    @@ -351,7 +373,11 @@
    clutter_win32_set_stage_foreign
    -

    X

    +
    +
    +
    +

    X

    +
    ClutterX11TexturePixmap
    ClutterX11TexturePixmapClass
    @@ -388,9 +414,13 @@
    clutter_x11_texture_pixmap_update_area
    +
    +
    +
    +
    + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/clutter-Events.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/clutter-Events.html @@ -8,7 +8,7 @@ - + @@ -62,8 +62,8 @@ Top -  |  - Description +  |  + Description
    @@ -77,8 +77,9 @@

    Synopsis

    -
    #define             CLUTTER_CURRENT_TIME
    -#define             CLUTTER_PRIORITY_EVENTS
    +
    +#define             CLUTTER_CURRENT_TIME
    +#define             CLUTTER_PRIORITY_EVENTS
     enum                ClutterModifierType;
     enum                ClutterScrollDirection;
     enum                ClutterStageState;
    @@ -91,44 +92,70 @@
                         ClutterScrollEvent;
                         ClutterStageStateEvent;
                         ClutterCrossingEvent;
    -ClutterEvent *      clutter_event_new                   (ClutterEventType type);
    -ClutterEvent *      clutter_event_copy                  (ClutterEvent *event);
    -void                clutter_event_free                  (ClutterEvent *event);
    -ClutterEventType    clutter_event_type                  (ClutterEvent *event);
    -
    -void                clutter_event_get_coords            (ClutterEvent *event,
    -                                                         gfloat *x,
    -                                                         gfloat *y);
    -ClutterModifierType  clutter_event_get_state            (ClutterEvent *event);
    -guint32             clutter_event_get_time              (ClutterEvent *event);
    -ClutterActor *      clutter_event_get_source            (ClutterEvent *event);
    -ClutterStage *      clutter_event_get_stage             (ClutterEvent *event);
    -ClutterEventFlags   clutter_event_get_flags             (ClutterEvent *event);
    -
    -ClutterEvent *      clutter_event_get                   (void);
    -ClutterEvent *      clutter_event_peek                  (void);
    -void                clutter_event_put                   (ClutterEvent *event);
    -gboolean            clutter_events_pending              (void);
    -
    -guint32             clutter_event_get_button            (ClutterEvent *event);
    -guint               clutter_event_get_click_count       (ClutterEvent *event);
    -
    -guint               clutter_event_get_key_symbol        (ClutterEvent *event);
    -guint16             clutter_event_get_key_code          (ClutterEvent *event);
    -guint32             clutter_event_get_key_unicode       (ClutterEvent *event);
    -guint32             clutter_keysym_to_unicode           (guint keyval);
    -
    -ClutterActor *      clutter_event_get_related           (ClutterEvent *event);
    -
    -ClutterScrollDirection  clutter_event_get_scroll_direction
    -                                                        (ClutterEvent *event);
    -
    -ClutterInputDevice * clutter_event_get_device           (ClutterEvent *event);
    -gint                clutter_event_get_device_id         (ClutterEvent *event);
    -ClutterInputDeviceType  clutter_event_get_device_type   (ClutterEvent *event);
    -
    -guint32             clutter_get_current_event_time      (void);
    -const ClutterEvent * clutter_get_current_event          (void);
    +ClutterEvent *      clutter_event_new                   (ClutterEventType type);
    +ClutterEvent *      clutter_event_copy                  (ClutterEvent *event);
    +void                clutter_event_free                  (ClutterEvent *event);
    +ClutterEventType    clutter_event_type                  (ClutterEvent *event);
    +
    +void                clutter_event_get_coords            (ClutterEvent *event,
    +                                                         gfloat *x,
    +                                                         gfloat *y);
    +ClutterModifierType  clutter_event_get_state            (ClutterEvent *event);
    +guint32             clutter_event_get_time              (ClutterEvent *event);
    +ClutterActor *      clutter_event_get_source            (ClutterEvent *event);
    +ClutterStage *      clutter_event_get_stage             (ClutterEvent *event);
    +ClutterEventFlags   clutter_event_get_flags             (ClutterEvent *event);
    +
    +ClutterEvent *      clutter_event_get                   (void);
    +ClutterEvent *      clutter_event_peek                  (void);
    +void                clutter_event_put                   (ClutterEvent *event);
    +gboolean            clutter_events_pending              (void);
    +
    +guint32             clutter_event_get_button            (ClutterEvent *event);
    +guint               clutter_event_get_click_count       (ClutterEvent *event);
    +
    +guint               clutter_event_get_key_symbol        (ClutterEvent *event);
    +guint16             clutter_event_get_key_code          (ClutterEvent *event);
    +guint32             clutter_event_get_key_unicode       (ClutterEvent *event);
    +guint32             clutter_keysym_to_unicode           (guint keyval);
    +
    +ClutterActor *      clutter_event_get_related           (ClutterEvent *event);
    +
    +ClutterScrollDirection  clutter_event_get_scroll_direction
    +                                                        (ClutterEvent *event);
    +
    +ClutterInputDevice * clutter_event_get_device           (ClutterEvent *event);
    +gint                clutter_event_get_device_id         (ClutterEvent *event);
    +ClutterInputDeviceType  clutter_event_get_device_type   (ClutterEvent *event);
    +
    +guint32             clutter_get_current_event_time      (void);
    +const ClutterEvent * clutter_get_current_event          (void);
     
    @@ -139,24 +166,30 @@

    The events usually come from the windowing backend, but can also be synthesized by Clutter itself or by the application code.

    +

    +

    Details

    -

    CLUTTER_CURRENT_TIME

    +

    CLUTTER_CURRENT_TIME

    #define CLUTTER_CURRENT_TIME    0L
     

    Default value for "now".

    +

    +

    Since 0.4


    -

    CLUTTER_PRIORITY_EVENTS

    +

    CLUTTER_PRIORITY_EVENTS

    #define CLUTTER_PRIORITY_EVENTS (G_PRIORITY_DEFAULT)
     

    Priority for event handling.

    +

    +

    Since 0.4


    @@ -190,96 +223,98 @@

    Masks applied to a ClutterEvent by modifiers.

    +

    +

    - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + @@ -300,26 +335,28 @@

    Direction of a pointer scroll event.

    +

    +

    CLUTTER_SHIFT_MASK

    CLUTTER_SHIFT_MASK

    Mask applied by the Shift key

    CLUTTER_LOCK_MASK

    CLUTTER_LOCK_MASK

    Mask applied by the Caps Lock key

    CLUTTER_CONTROL_MASK

    CLUTTER_CONTROL_MASK

    Mask applied by the Control key

    CLUTTER_MOD1_MASK

    CLUTTER_MOD1_MASK

    Mask applied by the first Mod key

    CLUTTER_MOD2_MASK

    CLUTTER_MOD2_MASK

    Mask applied by the second Mod key

    CLUTTER_MOD3_MASK

    CLUTTER_MOD3_MASK

    Mask applied by the third Mod key

    CLUTTER_MOD4_MASK

    CLUTTER_MOD4_MASK

    Mask applied by the fourth Mod key

    CLUTTER_MOD5_MASK

    CLUTTER_MOD5_MASK

    Mask applied by the fifth Mod key

    CLUTTER_BUTTON1_MASK

    CLUTTER_BUTTON1_MASK

    Mask applied by the first pointer button

    CLUTTER_BUTTON2_MASK

    CLUTTER_BUTTON2_MASK

    Mask applied by the second pointer button

    CLUTTER_BUTTON3_MASK

    CLUTTER_BUTTON3_MASK

    Mask applied by the third pointer button

    CLUTTER_BUTTON4_MASK

    CLUTTER_BUTTON4_MASK

    Mask applied by the fourth pointer button

    CLUTTER_BUTTON5_MASK

    CLUTTER_BUTTON5_MASK

    Mask applied by the fifth pointer button

    CLUTTER_SUPER_MASK

    CLUTTER_SUPER_MASK

    Mask applied by the Super key

    CLUTTER_HYPER_MASK

    CLUTTER_HYPER_MASK

    Mask applied by the Hyper key

    CLUTTER_META_MASK

    CLUTTER_META_MASK

    Mask applied by the Meta key

    CLUTTER_RELEASE_MASK

    CLUTTER_RELEASE_MASK

    Mask applied during release

    CLUTTER_MODIFIER_MASK

    CLUTTER_MODIFIER_MASK

    A mask covering all modifier types
    - + - + - + - + @@ -339,21 +376,23 @@

    Stage state masks

    +

    +

    CLUTTER_SCROLL_UP

    CLUTTER_SCROLL_UP

    Scroll up

    CLUTTER_SCROLL_DOWN

    CLUTTER_SCROLL_DOWN

    Scroll down

    CLUTTER_SCROLL_LEFT

    CLUTTER_SCROLL_LEFT

    Scroll left

    CLUTTER_SCROLL_RIGHT

    CLUTTER_SCROLL_RIGHT

    Scroll right
    - + - + - + @@ -383,71 +422,73 @@

    Types of events.

    +

    +

    CLUTTER_STAGE_STATE_FULLSCREEN

    CLUTTER_STAGE_STATE_FULLSCREEN

    Fullscreen mask

    CLUTTER_STAGE_STATE_OFFSCREEN

    CLUTTER_STAGE_STATE_OFFSCREEN

    Offscreen mask

    CLUTTER_STAGE_STATE_ACTIVATED

    CLUTTER_STAGE_STATE_ACTIVATED

    Activated mask
    - + - + - + - + - + - + - + - + - + - + - + - + - + @@ -473,6 +514,8 @@

    Generic event wrapper.

    +

    +

    Since 0.2


    @@ -485,16 +528,18 @@

    Flags for the ClutterEvent

    +

    +

    CLUTTER_NOTHING

    CLUTTER_NOTHING

    Empty event

    CLUTTER_KEY_PRESS

    CLUTTER_KEY_PRESS

    Key press event

    CLUTTER_KEY_RELEASE

    CLUTTER_KEY_RELEASE

    Key release event

    CLUTTER_MOTION

    CLUTTER_MOTION

    Pointer motion event

    CLUTTER_ENTER

    CLUTTER_ENTER

    Actor enter event

    CLUTTER_LEAVE

    CLUTTER_LEAVE

    Actor leave event

    CLUTTER_BUTTON_PRESS

    CLUTTER_BUTTON_PRESS

    Pointer button press event

    CLUTTER_BUTTON_RELEASE

    CLUTTER_BUTTON_RELEASE

    Pointer button release event

    CLUTTER_SCROLL

    CLUTTER_SCROLL

    Pointer scroll event

    CLUTTER_STAGE_STATE

    CLUTTER_STAGE_STATE

    Stage stage change event

    CLUTTER_DESTROY_NOTIFY

    CLUTTER_DESTROY_NOTIFY

    Destroy notification event

    CLUTTER_CLIENT_MESSAGE

    CLUTTER_CLIENT_MESSAGE

    Client message event

    CLUTTER_DELETE

    CLUTTER_DELETE

    Stage delete event
    - + - + @@ -528,67 +573,81 @@ The event coordinates are relative to the stage that received the event, and can be transformed into actor-relative coordinates by using clutter_actor_transform_stage_point().

    +

    +

    CLUTTER_EVENT_NONE

    CLUTTER_EVENT_NONE

    No flag set

    CLUTTER_EVENT_FLAG_SYNTHETIC

    CLUTTER_EVENT_FLAG_SYNTHETIC

    Synthetic event
    - + - + - + - + - + - + - + - + - + - + - + - + @@ -615,56 +674,66 @@

    Key event

    +

    +

    ClutterEventType type;

    ClutterEventType type;

    event type

    guint32 time;

    guint32 time;

    event time

    ClutterEventFlags flags;

    ClutterEventFlags flags;

    event flags

    ClutterStage *stage;

    ClutterStage *stage;

    event source stage

    ClutterActor *source;

    ClutterActor *source;

    event source actor

    gfloat x;

    gfloat x;

    event X coordinate, relative to the stage

    gfloat y;

    gfloat y;

    event Y coordinate, relative to the stage

    ClutterModifierType modifier_state;

    ClutterModifierType modifier_state;

    button modifiers

    guint32 button;

    guint32 button;

    event button

    guint click_count;

    guint click_count;

    number of button presses within the default time and radius

    gdouble *axes;

    gdouble *axes;

    reserved for future use

    ClutterInputDevice *device;

    ClutterInputDevice *device;

    reserved for future use
    - + - + - + - + - + - + - + - + - + - + @@ -691,56 +760,66 @@

    Event for the pointer motion

    +

    +

    ClutterEventType type;

    ClutterEventType type;

    event type

    guint32 time;

    guint32 time;

    event time

    ClutterEventFlags flags;

    ClutterEventFlags flags;

    event flags

    ClutterStage *stage;

    ClutterStage *stage;

    event source stage

    ClutterActor *source;

    ClutterActor *source;

    event source actor

    ClutterModifierType modifier_state;

    ClutterModifierType modifier_state;

    key modifiers

    guint keyval;

    guint keyval;

    raw key value

    guint16 hardware_keycode;

    guint16 hardware_keycode;

    raw hardware key value

    gunichar unicode_value;

    gunichar unicode_value;

    Unicode representation

    ClutterInputDevice *device;

    ClutterInputDevice *device;

    reserved for future use
    - + - + - + - + - + - + - + - + - + - + @@ -768,61 +847,71 @@

    Scroll wheel (or similar device) event

    +

    +

    ClutterEventType type;

    ClutterEventType type;

    event type

    guint32 time;

    guint32 time;

    event time

    ClutterEventFlags flags;

    ClutterEventFlags flags;

    event flags

    ClutterStage *stage;

    ClutterStage *stage;

    event source stage

    ClutterActor *source;

    ClutterActor *source;

    event source actor

    gfloat x;

    gfloat x;

    event X coordinate

    gfloat y;

    gfloat y;

    event Y coordinate

    ClutterModifierType modifier_state;

    ClutterModifierType modifier_state;

    button modifiers

    gdouble *axes;

    gdouble *axes;

    reserved for future use

    ClutterInputDevice *device;

    ClutterInputDevice *device;

    reserved for future use
    - + - + - + - + - + - + - + - + - + - + - + @@ -846,41 +935,45 @@

    Event signalling a change in the ClutterStage state.

    +

    +

    ClutterEventType type;

    ClutterEventType type;

    event type

    guint32 time;

    guint32 time;

    event time

    ClutterEventFlags flags;

    ClutterEventFlags flags;

    event flags

    ClutterStage *stage;

    ClutterStage *stage;

    event source stage

    ClutterActor *source;

    ClutterActor *source;

    event source actor

    gfloat x;

    gfloat x;

    event X coordinate

    gfloat y;

    gfloat y;

    event Y coordinate

    ClutterScrollDirection direction;

    ClutterScrollDirection direction;

    direction of the scrolling

    ClutterModifierType modifier_state;

    ClutterModifierType modifier_state;

    button modifiers

    gdouble *axes;

    gdouble *axes;

    reserved for future use

    ClutterInputDevice *device;

    ClutterInputDevice *device;

    reserved for future use
    - + - + - + - + - + - + - + @@ -906,51 +999,59 @@

    Event for the movement of the pointer across different actors

    +

    +

    ClutterEventType type;

    ClutterEventType type;

    event type

    guint32 time;

    guint32 time;

    event time

    ClutterEventFlags flags;

    ClutterEventFlags flags;

    event flags

    ClutterStage *stage;

    ClutterStage *stage;

    event source stage

    ClutterActor *source;

    ClutterActor *source;

    event source actor (unused)

    ClutterStageState changed_mask;

    ClutterStageState changed_mask;

    bitwise OR of the changed flags

    ClutterStageState new_state;

    ClutterStageState new_state;

    bitwise OR of the current state flags
    - + - + - + - + - + - + - + - + - + @@ -961,9 +1062,11 @@

    clutter_event_new ()

    -
    ClutterEvent *      clutter_event_new                   (ClutterEventType type);
    +
    ClutterEvent *      clutter_event_new                   (ClutterEventType type);

    Creates a new ClutterEvent of the specified type.

    +

    +

    ClutterEventType type;

    ClutterEventType type;

    event type

    guint32 time;

    guint32 time;

    event time

    ClutterEventFlags flags;

    ClutterEventFlags flags;

    event flags

    ClutterStage *stage;

    ClutterStage *stage;

    event source stage

    ClutterActor *source;

    ClutterActor *source;

    event source actor

    gfloat x;

    gfloat x;

    event X coordinate

    gfloat y;

    gfloat y;

    event Y coordinate

    ClutterInputDevice *device;

    ClutterInputDevice *device;

    reserved for future use

    ClutterActor *related;

    ClutterActor *related;

    actor related to the crossing
    @@ -983,9 +1086,11 @@

    clutter_event_copy ()

    -
    ClutterEvent *      clutter_event_copy                  (ClutterEvent *event);
    +
    ClutterEvent *      clutter_event_copy                  (ClutterEvent *event);

    Copies event.

    +

    +

    @@ -1005,9 +1110,11 @@

    clutter_event_free ()

    -
    void                clutter_event_free                  (ClutterEvent *event);
    +
    void                clutter_event_free                  (ClutterEvent *event);

    Frees all resources used by event.

    +

    +

    @@ -1020,9 +1127,11 @@

    clutter_event_type ()

    -
    ClutterEventType    clutter_event_type                  (ClutterEvent *event);
    +
    ClutterEventType    clutter_event_type                  (ClutterEvent *event);

    Retrieves the type of the event.

    +

    +

    @@ -1042,11 +1151,17 @@

    clutter_event_get_coords ()

    -
    void                clutter_event_get_coords            (ClutterEvent *event,
    -                                                         gfloat *x,
    -                                                         gfloat *y);
    +
    void                clutter_event_get_coords            (ClutterEvent *event,
    +                                                         gfloat *x,
    +                                                         gfloat *y);

    Retrieves the coordinates of event and puts them into x and y.

    +

    +

    @@ -1072,9 +1187,11 @@

    clutter_event_get_state ()

    -
    ClutterModifierType  clutter_event_get_state            (ClutterEvent *event);
    +
    ClutterModifierType  clutter_event_get_state            (ClutterEvent *event);

    Retrieves the modifier state of the event.

    +

    +

    @@ -1096,9 +1213,13 @@

    clutter_event_get_time ()

    -
    guint32             clutter_event_get_time              (ClutterEvent *event);
    +
    guint32             clutter_event_get_time              (ClutterEvent *event);

    Retrieves the time of the event.

    +

    +

    @@ -1109,7 +1230,7 @@ - @@ -1120,10 +1241,12 @@

    clutter_event_get_source ()

    -
    ClutterActor *      clutter_event_get_source            (ClutterEvent *event);
    +
    ClutterActor *      clutter_event_get_source            (ClutterEvent *event);

    Retrieves the source ClutterActor the event originated from, or NULL if the event has no source.

    +

    +

    Returns :

    the time of the event, or CLUTTER_CURRENT_TIME + the time of the event, or CLUTTER_CURRENT_TIME
    @@ -1134,7 +1257,7 @@ - +

    Returns :

    a ClutterActor. transfer none. a ClutterActor. transfer none.
    @@ -1143,10 +1266,12 @@

    clutter_event_get_stage ()

    -
    ClutterStage *      clutter_event_get_stage             (ClutterEvent *event);
    +
    ClutterStage *      clutter_event_get_stage             (ClutterEvent *event);

    Retrieves the source ClutterStage the event originated for, or -NULL if the event has no stage.

    +NULL if the event has no stage.

    +

    +

    @@ -1157,7 +1282,7 @@ - +

    Returns :

    a ClutterStage. transfer none. a ClutterStage. transfer none.
    @@ -1166,9 +1291,11 @@

    clutter_event_get_flags ()

    -
    ClutterEventFlags   clutter_event_get_flags             (ClutterEvent *event);
    +
    ClutterEventFlags   clutter_event_get_flags             (ClutterEvent *event);

    Retrieves the ClutterEventFlags of event

    +

    +

    @@ -1190,10 +1317,12 @@

    clutter_event_get ()

    -
    ClutterEvent *      clutter_event_get                   (void);
    +
    ClutterEvent *      clutter_event_get                   (void);

    Pops an event off the event queue. Applications should not need to call this.

    +

    +

    @@ -1208,15 +1337,17 @@

    clutter_event_peek ()

    -
    ClutterEvent *      clutter_event_peek                  (void);
    +
    ClutterEvent *      clutter_event_peek                  (void);

    Returns a pointer to the first event from the event queue but does not remove it.

    +

    +

    - +

    Returns :

    A ClutterEvent or NULL if queue empty.. transfer none. A ClutterEvent or NULL if queue empty.. transfer none.

    Since 0.4

    @@ -1224,13 +1355,15 @@

    clutter_event_put ()

    -
    void                clutter_event_put                   (ClutterEvent *event);
    +
    void                clutter_event_put                   (ClutterEvent *event);

    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 +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

    +

    +

    @@ -1244,9 +1377,13 @@

    clutter_events_pending ()

    -
    gboolean            clutter_events_pending              (void);
    +
    gboolean            clutter_events_pending              (void);

    Checks if events are pending in the event queue.

    +

    +

    @@ -1261,16 +1398,20 @@

    clutter_event_get_button ()

    -
    guint32             clutter_event_get_button            (ClutterEvent *event);
    +
    guint32             clutter_event_get_button            (ClutterEvent *event);

    Retrieves the button number of event

    +

    +

    - @@ -1286,16 +1427,20 @@

    clutter_event_get_click_count ()

    -
    guint               clutter_event_get_click_count       (ClutterEvent *event);
    +
    guint               clutter_event_get_click_count       (ClutterEvent *event);

    Retrieves the number of clicks of event

    +

    +

    event :

    a ClutterEvent of type CLUTTER_BUTTON_PRESS or - of type CLUTTER_BUTTON_RELEASE + a ClutterEvent of type CLUTTER_BUTTON_PRESS or + of type CLUTTER_BUTTON_RELEASE
    - @@ -1311,16 +1456,20 @@

    clutter_event_get_key_symbol ()

    -
    guint               clutter_event_get_key_symbol        (ClutterEvent *event);
    +
    guint               clutter_event_get_key_symbol        (ClutterEvent *event);

    Retrieves the key symbol of event

    +

    +

    event :

    a ClutterEvent of type CLUTTER_BUTTON_PRESS or - of type CLUTTER_BUTTON_RELEASE + a ClutterEvent of type CLUTTER_BUTTON_PRESS or + of type CLUTTER_BUTTON_RELEASE
    - @@ -1336,16 +1485,20 @@

    clutter_event_get_key_code ()

    -
    guint16             clutter_event_get_key_code          (ClutterEvent *event);
    +
    guint16             clutter_event_get_key_code          (ClutterEvent *event);

    Retrieves the keycode of the key that caused event

    +

    +

    event :

    a ClutterEvent of type CLUTTER_KEY_PRESS or - of type CLUTTER_KEY_RELEASE + a ClutterEvent of type CLUTTER_KEY_PRESS or + of type CLUTTER_KEY_RELEASE
    - @@ -1361,9 +1514,13 @@

    clutter_event_get_key_unicode ()

    -
    guint32             clutter_event_get_key_unicode       (ClutterEvent *event);
    +
    guint32             clutter_event_get_key_unicode       (ClutterEvent *event);

    Retrieves the unicode value for the key that caused keyev.

    +

    +

    event :

    a ClutterEvent of type CLUTTER_KEY_PRESS or - of type CLUTTER_KEY_RELEASE + a ClutterEvent of type CLUTTER_KEY_PRESS or + of type CLUTTER_KEY_RELEASE
    @@ -1383,10 +1540,16 @@

    clutter_keysym_to_unicode ()

    -
    guint32             clutter_keysym_to_unicode           (guint keyval);
    +
    guint32             clutter_keysym_to_unicode           (guint keyval);

    Convert from a Clutter key symbol to the corresponding ISO10646 (Unicode) character.

    +

    +

    @@ -1407,21 +1570,23 @@

    clutter_event_get_related ()

    -
    ClutterActor *      clutter_event_get_related           (ClutterEvent *event);
    +
    ClutterActor *      clutter_event_get_related           (ClutterEvent *event);

    Retrieves the related actor of a crossing event.

    +

    +

    - - +

    event :

    a ClutterEvent of type CLUTTER_ENTER or of - type CLUTTER_LEAVE + a ClutterEvent of type CLUTTER_ENTER or of + type CLUTTER_LEAVE

    Returns :

    the related ClutterActor, or NULL. transfer none. the related ClutterActor, or NULL. transfer none.
    @@ -1430,16 +1595,18 @@

    clutter_event_get_scroll_direction ()

    -
    ClutterScrollDirection  clutter_event_get_scroll_direction
    -                                                        (ClutterEvent *event);
    +
    ClutterScrollDirection  clutter_event_get_scroll_direction
    +                                                        (ClutterEvent *event);

    Retrieves the direction of the scrolling of event

    +

    +

    - @@ -1455,13 +1622,15 @@

    clutter_event_get_device ()

    -
    ClutterInputDevice * clutter_event_get_device           (ClutterEvent *event);
    +
    ClutterInputDevice * clutter_event_get_device           (ClutterEvent *event);

    Retrieves the ClutterInputDevice for the event.

    The ClutterInputDevice structure is completely opaque and should be cast to the platform-specific implementation.

    +

    +

    event :

    a ClutterEvent of type CLUTTER_SCROLL + a ClutterEvent of type CLUTTER_SCROLL
    @@ -1472,7 +1641,7 @@ - @@ -1483,9 +1652,13 @@

    clutter_event_get_device_id ()

    -
    gint                clutter_event_get_device_id         (ClutterEvent *event);
    +
    gint                clutter_event_get_device_id         (ClutterEvent *event);

    Retrieves the events device id if set.

    +

    +

    Returns :

    the ClutterInputDevice or NULL + the ClutterInputDevice or NULL
    @@ -1506,9 +1679,11 @@

    clutter_event_get_device_type ()

    -
    ClutterInputDeviceType  clutter_event_get_device_type   (ClutterEvent *event);
    +
    ClutterInputDeviceType  clutter_event_get_device_type   (ClutterEvent *event);

    Retrieves the type of the device for event

    +

    +

    @@ -1531,15 +1706,19 @@

    clutter_get_current_event_time ()

    -
    guint32             clutter_get_current_event_time      (void);
    +
    guint32             clutter_get_current_event_time      (void);

    Retrieves the timestamp of the last event, if there is an event or if the event has a timestamp.

    +

    +

    - @@ -1549,18 +1728,20 @@

    clutter_get_current_event ()

    -
    const ClutterEvent * clutter_get_current_event          (void);
    +
    const ClutterEvent * clutter_get_current_event          (void);

    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.

    +

    +

    Returns :

    the event timestamp, or CLUTTER_CURRENT_TIME + the event timestamp, or CLUTTER_CURRENT_TIME
    - +

    Returns :

    The current ClutterEvent, or NULL if none. transfer none. The current ClutterEvent, or NULL if none. transfer none.

    Since 1.2

    @@ -1569,6 +1750,6 @@
    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/clutter-EGLX-Specific-Support.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/clutter-EGLX-Specific-Support.html @@ -8,7 +8,7 @@ - + @@ -62,8 +62,8 @@ Top -  |  - Description +  |  + Description
    @@ -77,7 +77,8 @@

    Synopsis

    -
    EGLDisplay          clutter_eglx_display                (void);
    +
    +EGLDisplay          clutter_eglx_display                (void);
     
    @@ -85,14 +86,18 @@

    The EGLX backend for Clutter provides some specific API on top of the X11-specific one

    +

    +

    Details

    clutter_eglx_display ()

    -
    EGLDisplay          clutter_eglx_display                (void);
    +
    EGLDisplay          clutter_eglx_display                (void);

    Gets the current EGLDisplay.

    +

    +

    @@ -108,6 +113,6 @@ + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/clutter-subclassing-ClutterActor.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/clutter-subclassing-ClutterActor.html @@ -8,7 +8,7 @@ - + @@ -73,7 +73,9 @@

    In order to implement a new ClutterActor subclass the usual - machinery for subclassing a GObject should be used:

    + machinery for subclassing a GObject should be used:

     #define FOO_TYPE_ACTOR            (foo_actor_get_type ())
     #define FOO_ACTOR(obj)            (G_TYPE_CHECK_INSTANCE_CAST ((obj), FOO_TYPE_ACTOR, FooActor))
    @@ -326,7 +328,7 @@
     

    Note

    The allocate() virtual function implementation will be notified whether the actor has been moved, while clutter_actor_allocate() - will usually be invoked with the CLUTTER_ABSOLUTE_ORIGIN_CHANGED flag, + will usually be invoked with the CLUTTER_ABSOLUTE_ORIGIN_CHANGED flag, meaning that the parent has been moved.

    @@ -715,6 +717,6 @@
    + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ClutterBehaviourDepth.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ClutterBehaviourDepth.html @@ -8,7 +8,7 @@ - + @@ -62,14 +62,14 @@
    Top -  |  - Description -  |  - Object Hierarchy -  |  - Implemented Interfaces -  |  - Properties +  |  + Description +  |  + Object Hierarchy +  |  + Implemented Interfaces +  |  + Properties
    @@ -83,23 +83,38 @@

    Synopsis

    -
                        ClutterBehaviourDepth;
    +
    +                    ClutterBehaviourDepth;
                         ClutterBehaviourDepthClass;
    -ClutterBehaviour *  clutter_behaviour_depth_new         (ClutterAlpha *alpha,
    -                                                         gint depth_start,
    -                                                         gint depth_end);
    -void                clutter_behaviour_depth_set_bounds  (ClutterBehaviourDepth *behaviour,
    -                                                         gint depth_start,
    -                                                         gint depth_end);
    -void                clutter_behaviour_depth_get_bounds  (ClutterBehaviourDepth *behaviour,
    -                                                         gint *depth_start,
    -                                                         gint *depth_end);
    +ClutterBehaviour *  clutter_behaviour_depth_new         (ClutterAlpha *alpha,
    +                                                         gint depth_start,
    +                                                         gint depth_end);
    +void                clutter_behaviour_depth_set_bounds  (ClutterBehaviourDepth *behaviour,
    +                                                         gint depth_start,
    +                                                         gint depth_end);
    +void                clutter_behaviour_depth_get_bounds  (ClutterBehaviourDepth *behaviour,
    +                                                         gint *depth_start,
    +                                                         gint *depth_end);
     

    Object Hierarchy

    -  GObject
    +  GObject
        +----ClutterBehaviour
              +----ClutterBehaviourDepth
     
    @@ -113,8 +128,12 @@

    Properties

    -  "depth-end"                gint                  : Read / Write
    -  "depth-start"              gint                  : Read / Write
    +  "depth-end"                gint                  : Read / Write
    +  "depth-start"              gint                  : Read / Write
     
    @@ -125,6 +144,8 @@

    ClutterBehaviourDepth is available since Clutter 0.4.

    +

    +

    Details

    @@ -134,6 +155,8 @@

    The ClutterBehaviourDepth structure contains only private data and should be accessed using the provided API

    +

    +

    Since 0.2


    @@ -144,23 +167,31 @@

    The ClutterBehaviourDepthClass structure contains only private data

    +

    +

    Since 0.2


    clutter_behaviour_depth_new ()

    -
    ClutterBehaviour *  clutter_behaviour_depth_new         (ClutterAlpha *alpha,
    -                                                         gint depth_start,
    -                                                         gint depth_end);
    +
    ClutterBehaviour *  clutter_behaviour_depth_new         (ClutterAlpha *alpha,
    +                                                         gint depth_start,
    +                                                         gint depth_end);

    Creates a new ClutterBehaviourDepth which can be used to control the ClutterActor:depth property of a set of ClutterActors.

    +

    +

    - @@ -186,11 +217,17 @@

    clutter_behaviour_depth_set_bounds ()

    -
    void                clutter_behaviour_depth_set_bounds  (ClutterBehaviourDepth *behaviour,
    -                                                         gint depth_start,
    -                                                         gint depth_end);
    +
    void                clutter_behaviour_depth_set_bounds  (ClutterBehaviourDepth *behaviour,
    +                                                         gint depth_start,
    +                                                         gint depth_end);

    Sets the boundaries of the behaviour.

    +

    +

    alpha :

    a ClutterAlpha or NULL + a ClutterAlpha or NULL
    @@ -216,11 +253,17 @@

    clutter_behaviour_depth_get_bounds ()

    -
    void                clutter_behaviour_depth_get_bounds  (ClutterBehaviourDepth *behaviour,
    -                                                         gint *depth_start,
    -                                                         gint *depth_end);
    +
    void                clutter_behaviour_depth_get_bounds  (ClutterBehaviourDepth *behaviour,
    +                                                         gint *depth_start,
    +                                                         gint *depth_end);

    Gets the boundaries of the behaviour

    +

    +

    @@ -231,12 +274,12 @@ - - @@ -248,25 +291,33 @@

    Property Details

    The "depth-end" property

    -
      "depth-end"                gint                  : Read / Write
    +
      "depth-end"                gint                  : Read / Write

    End depth level to apply to the actors.

    +

    +

    Default value: 0

    -

    Since 0.4

    +

    Since 0.4


    The "depth-start" property

    -
      "depth-start"              gint                  : Read / Write
    +
      "depth-start"              gint                  : Read / Write

    Start depth level to apply to the actors.

    +

    +

    Default value: 0

    -

    Since 0.4

    +

    Since 0.4

    + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/clutter-EGL-Specific-Support.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/clutter-EGL-Specific-Support.html @@ -8,7 +8,7 @@ - + @@ -62,8 +62,8 @@

    depth_start :

    return location for the initial depth value, or NULL + return location for the initial depth value, or NULL

    depth_end :

    return location for the final depth value, or NULL + return location for the final depth value, or NULL
    Top -  |  - Description +  |  + Description
    @@ -77,21 +77,26 @@

    Synopsis

    -
    EGLDisplay          clutter_egl_display                 (void);
    +
    +EGLDisplay          clutter_egl_display                 (void);
     

    Description

    The EGL backend for Clutter provides some specific API.

    +

    +

    Details

    clutter_egl_display ()

    -
    EGLDisplay          clutter_egl_display                 (void);
    +
    EGLDisplay          clutter_egl_display                 (void);

    Retrieves the EGLDisplay used by Clutter

    +

    +

    @@ -105,6 +110,6 @@ + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/building-clutter.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/building-clutter.html @@ -8,7 +8,7 @@ - + @@ -312,6 +312,6 @@ + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/cluttertools.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/cluttertools.html @@ -8,7 +8,7 @@ - + @@ -130,6 +130,6 @@ + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/clutter-overview.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/clutter-overview.html @@ -8,7 +8,7 @@ - + @@ -104,6 +104,6 @@ + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/style.css +++ clutter-1.0-1.2.4/doc/reference/clutter/html/style.css @@ -1,15 +1,13 @@ .synopsis, .classsynopsis { - /* tango:aluminium 1/2 */ - background: #eeeeec; - border: solid 1px #d3d7cf; + background: #eeeeee; + border: solid 1px #aaaaaa; padding: 0.5em; } .programlisting { - /* tango:sky blue 0/1 */ - background: #e6f3ff; - border: solid 1px #729fcf; + background: #eeeeff; + border: solid 1px #aaaaff; padding: 0.5em; } .variablelist @@ -22,63 +20,64 @@ vertical-align: top; } +/* this is needed so that the local anchors are displayed below the naviagtion */ @media screen { sup a.footnote { position: relative; top: 0em ! important; - } - /* this is needed so that the local anchors are displayed below the naviagtion */ - div.footnote a[name], div.refnamediv a[name], div.refsect1 a[name], div.refsect2 a[name], div.index a[name], div.glossary a[name], div.sect1 a[name] + div.refnamediv a[name], div.refsect1 a[name] { position: relative; - padding-top:4.5em; + top: -4.5em; } - /* this seems to be a bug in the xsl style sheets when generating indexes */ - div.index div.index - { - top: 0em; - } - /* make space for the fixed navigation bar and add space at the bottom so that - * link targets appear somewhat close to top - */ - body - { - padding-top: 3.2em; - padding-bottom: 20em; - } - /* style and size the navigation bar */ table.navigation#top { - position: fixed; - /* tango:scarlet red 0/1 */ - background: #ffe6e6; - border: solid 1px #ef2929; + background: #ffeeee; + border: solid 1px #ffaaaa; margin-top: 0; margin-bottom: 0; + position: fixed; top: 0; left: 0; - height: 3em; - z-index: 10; + height: 2em; + z-index: 1; } - .navigation a, .navigation a:visited + .navigation a { - /* tango:scarlet red 3 */ - color: #a40000; + color: #770000; } - .navigation a:hover + .navigation a:visited { - /* tango:scarlet red 1 */ - color: #ef2929; + color: #550000; } td.shortcuts { - /* tango:scarlet red 1 */ - color: #ef2929; + color: #770000; font-size: 80%; white-space: nowrap; } + div.refentry, div.chapter, div.reference, div.part, div.book, div.glossary, div.sect1, div.appendix, div.preface + { + position: relative; + top: 3em; + z-index: 0; + } + div.glossary, div.index + { + position: relative; + top: 2em; + z-index: 0; + } + div.refnamediv + { + margin-top: 2em; + } + body + { + padding-bottom: 20em; + } } @media print { table.navigation { @@ -88,14 +87,13 @@ div.titlepage table.navigation { visibility: visible; display: table; - /* tango:scarlet red 0/1 */ - background: #ffe6e6; - border: solid 1px #ef2929; + background: #ffeeee; + border: solid 1px #ffaaaa; margin-top: 0; margin-bottom: 0; top: 0; left: 0; - height: 3em; + height: 2em; } } @@ -104,6 +102,7 @@ font-size: 200%; } + div.gallery-float { float: left; @@ -117,48 +116,44 @@ { clear: both; } - -a, a:visited +a { text-decoration: none; - /* tango:sky blue 2 */ - color: #3465a4; } a:hover { text-decoration: underline; - /* tango:sky blue 1 */ - color: #729fcf; + color: #FF0000; } div.table table { border-collapse: collapse; border-spacing: 0px; - /* tango:aluminium 3 */ - border: solid 1px #babdb6; + border-style: solid; + border-color: #777777; + border-width: 1px; } div.table table td, div.table table th { - /* tango:aluminium 3 */ - border: solid 1px #babdb6; + border-style: solid; + border-color: #777777; + border-width: 1px; padding: 3px; vertical-align: top; } div.table table th { - /* tango:aluminium 2 */ - background-color: #d3d7cf; + background-color: #eeeeee; } hr { - /* tango:aluminium 3 */ - color: #babdb6; - background: #babdb6; - border: none 0px; + color: #777777; + background: #777777; + border: 0; height: 1px; clear: both; } @@ -166,92 +161,7 @@ .footer { padding-top: 3.5em; - /* tango:aluminium 3 */ - color: #babdb6; + color: #777777; text-align: center; font-size: 80%; } - -.warning -{ - /* tango:orange 0/1 */ - background: #ffeed9; - border-color: #ffb04f; -} -.note -{ - /* tango:chameleon 0/0.5 */ - background: #d8ffb2; - border-color: #abf562; -} -.note, .warning -{ - padding: 0.5em; - border-width: 1px; - border-style: solid; -} -.note h3, .warning h3 -{ - margin-top: 0.0em -} -.note p, .warning p -{ - margin-bottom: 0.0em -} - -/* blob links */ -h2 .extralinks, h3 .extralinks -{ - float: right; - /* tango:aluminium 3 */ - color: #babdb6; - font-size: 80%; - font-weight: normal; -} - -/* code listings */ - -.programlisting .cbracket { color: #a40000; } /* tango: scarlet red 3 */ -.programlisting .comment { color: #a1a39d; } /* tango: aluminium 4 */ -.programlisting .function { color: #000000; font-weight: bold; } -.programlisting .function a { color: #11326b; font-weight: bold; } /* tango: sky blue 4 */ -.programlisting .keyword { color: #4e9a06; } /* tango: chameleon 3 */ -.programlisting .linenum { color: #babdb6; } /* tango: aluminium 3 */ -.programlisting .normal { color: #000000; } -.programlisting .number { color: #75507b; } /* tango: plum 2 */ -.programlisting .preproc { color: #204a87; } /* tango: sky blue 3 */ -.programlisting .string { color: #c17d11; } /* tango: chocolate 2 */ -.programlisting .type { color: #000000; } -.programlisting .type a { color: #11326b; } /* tango: sky blue 4 */ -.programlisting .symbol { color: #ce5c00; } /* tango: orange 3 */ - -.listing_frame { - /* tango:sky blue 1 */ - border: solid 1px #729fcf; - padding: 0px; -} - -.listing_lines, .listing_code { - margin-top: 0px; - margin-bottom: 0px; - padding: 0.5em; -} -.listing_lines { - /* tango:sky blue 0.5 */ - background: #a6c5e3; - /* tango:aluminium 6 */ - color: #2e3436; -} -.listing_code { - /* tango:sky blue 0 */ - background: #e6f3ff; -} -.listing_code .programlisting { - /* override from previous */ - border: none 0px; - padding: 0px; -} -.listing_lines pre, .listing_code pre { - margin: 0px; -} - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/iterating-paths.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/iterating-paths.html @@ -8,7 +8,7 @@ - + @@ -65,7 +65,9 @@

    It is possible to iterate over all the ClutterPathNodes inside a ClutterPath by using clutter_path_get_nodes(), which will return - a GSList of ClutterPathNodes; or by using clutter_path_foreach() + a GSList of ClutterPathNodes; or by using clutter_path_foreach() with a function.

    The function pointer passed to clutter_path_foreach() should have the following definition:

    @@ -79,6 +81,6 @@ + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ix03.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ix03.html @@ -8,7 +8,7 @@ - + @@ -52,42 +52,20 @@ -
    - + - - - +

    -Index of new symbols in 0.2

    -

    A

    +Index of new symbols in 0.2
    +
    + + + +
    +

    E

    +
    ClutterEvent
    -

    G

    +
    +
    + + +
    +

    K

    +
    ClutterKeyEvent
    ClutterKnot
    @@ -236,8 +238,12 @@
    clutter_knot_free
    -

    M

    -
    ClutterMedia
    +
    +
    +
    +

    M

    +
    +
    ClutterMedia
    ClutterMedia::eos
    @@ -269,7 +275,11 @@
    ClutterMotionEvent
    -

    R

    +
    +
    + + + +
    +
    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/clutter-X11-Specific-Support.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/clutter-X11-Specific-Support.html @@ -8,7 +8,7 @@ - + @@ -62,8 +62,8 @@ Top -  |  - Description +  |  + Description
    @@ -77,64 +77,99 @@

    Synopsis

    -
    void                clutter_x11_set_display             (Display *xdpy);
    -void                clutter_x11_disable_event_retrieval (void);
    -gboolean            clutter_x11_has_event_retrieval     (void);
    -ClutterStage *      clutter_x11_get_stage_from_window   (Window win);
    -ClutterX11FilterReturn  clutter_x11_handle_event        (XEvent *xevent);
    -Display *           clutter_x11_get_default_display     (void);
    -int                 clutter_x11_get_default_screen      (void);
    -Window              clutter_x11_get_root_window         (void);
    -XVisualInfo *       clutter_x11_get_stage_visual        (ClutterStage *stage);
    -Window              clutter_x11_get_stage_window        (ClutterStage *stage);
    -gboolean            clutter_x11_set_stage_foreign       (ClutterStage *stage,
    -                                                         Window xwindow);
    -void                clutter_x11_trap_x_errors           (void);
    -gint                clutter_x11_untrap_x_errors         (void);
    -gboolean            clutter_x11_has_composite_extension (void);
    -Time                clutter_x11_get_current_event_time  (void);
    -void                clutter_x11_set_use_argb_visual     (gboolean use_argb);
    -gboolean            clutter_x11_get_use_argb_visual     (void);
    -XVisualInfo *       clutter_x11_get_visual_info         (void);
    -
    -ClutterX11FilterReturn  (*ClutterX11FilterFunc)         (XEvent *xev,
    -                                                         ClutterEvent *cev,
    -                                                         gpointer data);
    +
    +void                clutter_x11_set_display             (Display *xdpy);
    +void                clutter_x11_disable_event_retrieval (void);
    +gboolean            clutter_x11_has_event_retrieval     (void);
    +ClutterStage *      clutter_x11_get_stage_from_window   (Window win);
    +ClutterX11FilterReturn  clutter_x11_handle_event        (XEvent *xevent);
    +Display *           clutter_x11_get_default_display     (void);
    +int                 clutter_x11_get_default_screen      (void);
    +Window              clutter_x11_get_root_window         (void);
    +XVisualInfo *       clutter_x11_get_stage_visual        (ClutterStage *stage);
    +Window              clutter_x11_get_stage_window        (ClutterStage *stage);
    +gboolean            clutter_x11_set_stage_foreign       (ClutterStage *stage,
    +                                                         Window xwindow);
    +void                clutter_x11_trap_x_errors           (void);
    +gint                clutter_x11_untrap_x_errors         (void);
    +gboolean            clutter_x11_has_composite_extension (void);
    +Time                clutter_x11_get_current_event_time  (void);
    +void                clutter_x11_set_use_argb_visual     (gboolean use_argb);
    +gboolean            clutter_x11_get_use_argb_visual     (void);
    +XVisualInfo *       clutter_x11_get_visual_info         (void);
    +
    +ClutterX11FilterReturn  (*ClutterX11FilterFunc)         (XEvent *xev,
    +                                                         ClutterEvent *cev,
    +                                                         gpointer data);
     enum                ClutterX11FilterReturn;
    -void                clutter_x11_add_filter              (ClutterX11FilterFunc func,
    -                                                         gpointer data);
    -void                clutter_x11_remove_filter           (ClutterX11FilterFunc func,
    -                                                         gpointer data);
    -
    -const GSList*       clutter_x11_get_input_devices       (void);
    -gboolean            clutter_x11_has_xinput              (void);
    -void                clutter_x11_enable_xinput           (void);
    +void                clutter_x11_add_filter              (ClutterX11FilterFunc func,
    +                                                         gpointer data);
    +void                clutter_x11_remove_filter           (ClutterX11FilterFunc func,
    +                                                         gpointer data);
    +
    +const GSList*       clutter_x11_get_input_devices       (void);
    +gboolean            clutter_x11_has_xinput              (void);
    +void                clutter_x11_enable_xinput           (void);
     
                         ClutterX11TexturePixmap;
                         ClutterX11TexturePixmapClass;
    -ClutterActor *      clutter_x11_texture_pixmap_new      (void);
    -ClutterActor *      clutter_x11_texture_pixmap_new_with_pixmap
    -                                                        (Pixmap pixmap);
    -ClutterActor *      clutter_x11_texture_pixmap_new_with_window
    -                                                        (Window window);
    -void                clutter_x11_texture_pixmap_set_pixmap
    -                                                        (ClutterX11TexturePixmap *texture,
    -                                                         Pixmap pixmap);
    -void                clutter_x11_texture_pixmap_set_window
    -                                                        (ClutterX11TexturePixmap *texture,
    -                                                         Window window,
    -                                                         gboolean automatic);
    -void                clutter_x11_texture_pixmap_sync_window
    -                                                        (ClutterX11TexturePixmap *texture);
    -void                clutter_x11_texture_pixmap_update_area
    -                                                        (ClutterX11TexturePixmap *texture,
    -                                                         gint x,
    -                                                         gint y,
    -                                                         gint width,
    -                                                         gint height);
    -void                clutter_x11_texture_pixmap_set_automatic
    -                                                        (ClutterX11TexturePixmap *texture,
    -                                                         gboolean setting);
    +ClutterActor *      clutter_x11_texture_pixmap_new      (void);
    +ClutterActor *      clutter_x11_texture_pixmap_new_with_pixmap
    +                                                        (Pixmap pixmap);
    +ClutterActor *      clutter_x11_texture_pixmap_new_with_window
    +                                                        (Window window);
    +void                clutter_x11_texture_pixmap_set_pixmap
    +                                                        (ClutterX11TexturePixmap *texture,
    +                                                         Pixmap pixmap);
    +void                clutter_x11_texture_pixmap_set_window
    +                                                        (ClutterX11TexturePixmap *texture,
    +                                                         Window window,
    +                                                         gboolean automatic);
    +void                clutter_x11_texture_pixmap_sync_window
    +                                                        (ClutterX11TexturePixmap *texture);
    +void                clutter_x11_texture_pixmap_update_area
    +                                                        (ClutterX11TexturePixmap *texture,
    +                                                         gint x,
    +                                                         gint y,
    +                                                         gint width,
    +                                                         gint height);
    +void                clutter_x11_texture_pixmap_set_automatic
    +                                                        (ClutterX11TexturePixmap *texture,
    +                                                         gboolean setting);
     
    @@ -146,12 +181,14 @@

    The ClutterX11 API is available since Clutter 0.6

    +

    +

    Details

    clutter_x11_set_display ()

    -
    void                clutter_x11_set_display             (Display *xdpy);
    +
    void                clutter_x11_set_display             (Display *xdpy);

    Sets the display connection Clutter should use; must be called before clutter_init(), clutter_init_with_args() or other functions @@ -159,9 +196,17 @@

    If you are parsing the command line arguments by retrieving Clutter's -GOptionGroup with clutter_get_option_group() and calling -g_option_context_parse() yourself, you should also call -clutter_x11_set_display() before g_option_context_parse().

    +GOptionGroup with clutter_get_option_group() and calling +g_option_context_parse() yourself, you should also call +clutter_x11_set_display() before g_option_context_parse().

    +

    +

    @@ -175,21 +220,27 @@

    clutter_x11_disable_event_retrieval ()

    -
    void                clutter_x11_disable_event_retrieval (void);
    +
    void                clutter_x11_disable_event_retrieval (void);

    Disables retrieval of X events in the main loop. Use to create event-less canvas or in conjunction with clutter_x11_handle_event.

    This function can only be called before calling clutter_init().

    +

    +

    Since 0.8


    clutter_x11_has_event_retrieval ()

    -
    gboolean            clutter_x11_has_event_retrieval     (void);
    +
    gboolean            clutter_x11_has_event_retrieval     (void);

    Queries the X11 backend to check if event collection has been disabled.

    +

    +

    @@ -204,9 +255,11 @@

    clutter_x11_get_stage_from_window ()

    -
    ClutterStage *      clutter_x11_get_stage_from_window   (Window win);
    +
    ClutterStage *      clutter_x11_get_stage_from_window   (Window win);

    Gets the stage for a particular X window.

    +

    +

    @@ -228,10 +281,12 @@

    clutter_x11_handle_event ()

    -
    ClutterX11FilterReturn  clutter_x11_handle_event        (XEvent *xevent);
    +
    ClutterX11FilterReturn  clutter_x11_handle_event        (XEvent *xevent);

    This function processes a single X event; it can be used to hook into external X event retrieval (for example that done by GDK).

    +

    +

    @@ -242,12 +297,12 @@ - @@ -259,9 +314,11 @@

    clutter_x11_get_default_display ()

    -
    Display *           clutter_x11_get_default_display     (void);
    +
    Display *           clutter_x11_get_default_display     (void);

    Retrieves the pointer to the default display.

    +

    +

    Returns :

    ClutterX11FilterReturn. CLUTTER_X11_FILTER_REMOVE + ClutterX11FilterReturn. CLUTTER_X11_FILTER_REMOVE indicates that Clutter has internally handled the event and the - caller should do no further processing. CLUTTER_X11_FILTER_CONTINUE + caller should do no further processing. CLUTTER_X11_FILTER_CONTINUE indicates that Clutter is either not interested in the event, or has used the event to update internal state without taking - any exclusive action. CLUTTER_X11_FILTER_TRANSLATE will not + any exclusive action. CLUTTER_X11_FILTER_TRANSLATE will not occur.
    @@ -276,9 +333,11 @@

    clutter_x11_get_default_screen ()

    -
    int                 clutter_x11_get_default_screen      (void);
    +
    int                 clutter_x11_get_default_screen      (void);

    Gets the number of the default X Screen object.

    +

    +

    @@ -293,9 +352,11 @@

    clutter_x11_get_root_window ()

    -
    Window              clutter_x11_get_root_window         (void);
    +
    Window              clutter_x11_get_root_window         (void);

    Retrieves the root window.

    +

    +

    @@ -310,7 +371,7 @@

    clutter_x11_get_stage_visual ()

    -
    XVisualInfo *       clutter_x11_get_stage_visual        (ClutterStage *stage);
    +
    XVisualInfo *       clutter_x11_get_stage_visual        (ClutterStage *stage);

    Warning

    clutter_x11_get_stage_visual has been deprecated since version 1.2 and should not be used in newly-written code. Use clutter_x11_get_visual_info() instead

    @@ -324,6 +385,8 @@ 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()

    +

    +

    @@ -346,9 +409,11 @@

    clutter_x11_get_stage_window ()

    -
    Window              clutter_x11_get_stage_window        (ClutterStage *stage);
    +
    Window              clutter_x11_get_stage_window        (ClutterStage *stage);

    Gets the stages X Window.

    +

    +

    @@ -370,10 +435,14 @@

    clutter_x11_set_stage_foreign ()

    -
    gboolean            clutter_x11_set_stage_foreign       (ClutterStage *stage,
    -                                                         Window xwindow);
    +
    gboolean            clutter_x11_set_stage_foreign       (ClutterStage *stage,
    +                                                         Window xwindow);

    Target the ClutterStage to use an existing external X Window

    +

    +

    @@ -389,7 +458,7 @@ - @@ -400,17 +469,23 @@

    clutter_x11_trap_x_errors ()

    -
    void                clutter_x11_trap_x_errors           (void);
    +
    void                clutter_x11_trap_x_errors           (void);

    Traps every X error until clutter_x11_untrap_x_errors() is called.

    +

    +

    Since 0.6


    clutter_x11_untrap_x_errors ()

    -
    gint                clutter_x11_untrap_x_errors         (void);
    +
    gint                clutter_x11_untrap_x_errors         (void);

    Removes the X error trap and returns the current status.

    +

    +

    Returns :

    TRUE if foreign window is valid + TRUE if foreign window is valid
    @@ -425,15 +500,19 @@

    clutter_x11_has_composite_extension ()

    -
    gboolean            clutter_x11_has_composite_extension (void);
    +
    gboolean            clutter_x11_has_composite_extension (void);

    Retrieves whether Clutter is running on an X11 server with the XComposite extension

    +

    +

    -

    Returns :

    TRUE if the XComposite extension is available + TRUE if the XComposite extension is available
    @@ -441,12 +520,14 @@

    clutter_x11_get_current_event_time ()

    -
    Time                clutter_x11_get_current_event_time  (void);
    +
    Time                clutter_x11_get_current_event_time  (void);

    Retrieves the timestamp of the last X11 event processed by Clutter. This might be different from the timestamp returned by clutter_get_current_event_time(), as Clutter may synthesize or throttle events.

    +

    +

    @@ -461,7 +542,9 @@

    clutter_x11_set_use_argb_visual ()

    -
    void                clutter_x11_set_use_argb_visual     (gboolean use_argb);
    +
    void                clutter_x11_set_use_argb_visual     (gboolean use_argb);

    Sets whether the Clutter X11 backend should request ARGB visuals by default or not. @@ -484,11 +567,13 @@

    Note

    This function can only be called once, and before clutter_init() is called.
    +

    +

    -

    use_argb :

    TRUE if ARGB visuals should be requested by default + TRUE if ARGB visuals should be requested by default
    @@ -497,14 +582,18 @@

    clutter_x11_get_use_argb_visual ()

    -
    gboolean            clutter_x11_get_use_argb_visual     (void);
    +
    gboolean            clutter_x11_get_use_argb_visual     (void);

    Retrieves whether the Clutter X11 backend is using ARGB visuals by default

    +

    +

    - @@ -514,10 +603,12 @@

    clutter_x11_get_visual_info ()

    -
    XVisualInfo *       clutter_x11_get_visual_info         (void);
    +
    XVisualInfo *       clutter_x11_get_visual_info         (void);

    Retrieves the XVisualInfo used by the Clutter X11 backend.

    +

    +

    Returns :

    TRUE if ARGB visuals are queried by default + TRUE if ARGB visuals are queried by default
    @@ -534,11 +625,15 @@

    ClutterX11FilterFunc ()

    -
    ClutterX11FilterReturn  (*ClutterX11FilterFunc)         (XEvent *xev,
    -                                                         ClutterEvent *cev,
    -                                                         gpointer data);
    +
    ClutterX11FilterReturn  (*ClutterX11FilterFunc)         (XEvent *xev,
    +                                                         ClutterEvent *cev,
    +                                                         gpointer data);

    Filter function for X11 native events.

    +

    +

    @@ -578,23 +673,25 @@

    Return values for the ClutterX11FilterFunc function.

    +

    +

    - + - + - + @@ -605,10 +702,14 @@

    clutter_x11_add_filter ()

    -
    void                clutter_x11_add_filter              (ClutterX11FilterFunc func,
    -                                                         gpointer data);
    +
    void                clutter_x11_add_filter              (ClutterX11FilterFunc func,
    +                                                         gpointer data);

    Adds an event filter function.

    +

    +

    CLUTTER_X11_FILTER_CONTINUE

    CLUTTER_X11_FILTER_CONTINUE

    The event was not handled, continues the processing

    CLUTTER_X11_FILTER_TRANSLATE

    CLUTTER_X11_FILTER_TRANSLATE

    Native event translated into a Clutter event, stops the processing

    CLUTTER_X11_FILTER_REMOVE

    CLUTTER_X11_FILTER_REMOVE

    Remove the event, stops the processing
    @@ -619,7 +720,7 @@ - @@ -629,10 +730,14 @@

    clutter_x11_remove_filter ()

    -
    void                clutter_x11_remove_filter           (ClutterX11FilterFunc func,
    -                                                         gpointer data);
    +
    void                clutter_x11_remove_filter           (ClutterX11FilterFunc func,
    +                                                         gpointer data);

    Removes the given filter function.

    +

    +

    data :

    user data to be passed to the filter function, or NULL + user data to be passed to the filter function, or NULL
    @@ -643,7 +748,7 @@ - @@ -653,13 +758,17 @@

    clutter_x11_get_input_devices ()

    -
    const GSList*       clutter_x11_get_input_devices       (void);
    +
    const GSList*       clutter_x11_get_input_devices       (void);

    Warning

    clutter_x11_get_input_devices has been deprecated since version 1.2 and should not be used in newly-written code. Use clutter_device_manager_peek_devices() instead

    Retrieves a pointer to the list of input devices

    +

    +

    data :

    user data to be passed to the filter function, or NULL + user data to be passed to the filter function, or NULL
    @@ -675,14 +784,18 @@

    clutter_x11_has_xinput ()

    -
    gboolean            clutter_x11_has_xinput              (void);
    +
    gboolean            clutter_x11_has_xinput              (void);

    Gets whether Clutter has XInput support.

    +

    +

    - @@ -693,7 +806,7 @@

    clutter_x11_enable_xinput ()

    -
    void                clutter_x11_enable_xinput           (void);
    +
    void                clutter_x11_enable_xinput           (void);

    Enables the use of the XInput extension if present on connected XServer and support built into Clutter. XInput allows for multiple @@ -705,6 +818,8 @@

    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


    @@ -715,6 +830,8 @@

    The ClutterX11TexturePixmap structure contains only private data

    +

    +

    Since 0.8


    @@ -730,10 +847,12 @@

    The ClutterX11TexturePixmapClass structure contains only private data

    +

    +

    Returns :

    TRUE if Clutter was compiled with XInput support + TRUE if Clutter was compiled with XInput support and XInput support is available at run time.
    - + @@ -743,10 +862,12 @@

    clutter_x11_texture_pixmap_new ()

    -
    ClutterActor *      clutter_x11_texture_pixmap_new      (void);
    +
    ClutterActor *      clutter_x11_texture_pixmap_new      (void);

    Creates a new ClutterX11TexturePixmap which can be used to display the contents of an X11 Pixmap inside a Clutter scene graph

    +

    +

    update_area ()

    update_area ()

    virtual function for updating the area of the texture
    @@ -761,10 +882,12 @@

    clutter_x11_texture_pixmap_new_with_pixmap ()

    -
    ClutterActor *      clutter_x11_texture_pixmap_new_with_pixmap
    -                                                        (Pixmap pixmap);
    +
    ClutterActor *      clutter_x11_texture_pixmap_new_with_pixmap
    +                                                        (Pixmap pixmap);

    Creates a new ClutterX11TexturePixmap for pixmap

    +

    +

    @@ -786,10 +909,12 @@

    clutter_x11_texture_pixmap_new_with_window ()

    -
    ClutterActor *      clutter_x11_texture_pixmap_new_with_window
    -                                                        (Window window);
    +
    ClutterActor *      clutter_x11_texture_pixmap_new_with_window
    +                                                        (Window window);

    Creates a new ClutterX11TexturePixmap for window

    +

    +

    @@ -811,11 +936,13 @@

    clutter_x11_texture_pixmap_set_pixmap ()

    -
    void                clutter_x11_texture_pixmap_set_pixmap
    -                                                        (ClutterX11TexturePixmap *texture,
    -                                                         Pixmap pixmap);
    +
    void                clutter_x11_texture_pixmap_set_pixmap
    +                                                        (ClutterX11TexturePixmap *texture,
    +                                                         Pixmap pixmap);

    Sets the X Pixmap to which the texture should be bound.

    +

    +

    @@ -836,10 +963,12 @@

    clutter_x11_texture_pixmap_set_window ()

    -
    void                clutter_x11_texture_pixmap_set_window
    -                                                        (ClutterX11TexturePixmap *texture,
    -                                                         Window window,
    -                                                         gboolean automatic);
    +
    void                clutter_x11_texture_pixmap_set_window
    +                                                        (ClutterX11TexturePixmap *texture,
    +                                                         Window window,
    +                                                         gboolean automatic);

    Sets up a suitable pixmap for the window, using the composite and damage extensions if possible, and then calls @@ -848,6 +977,8 @@

    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()

    +

    +

    @@ -863,7 +994,7 @@ - @@ -873,11 +1004,13 @@

    clutter_x11_texture_pixmap_sync_window ()

    -
    void                clutter_x11_texture_pixmap_sync_window
    -                                                        (ClutterX11TexturePixmap *texture);
    +
    void                clutter_x11_texture_pixmap_sync_window
    +                                                        (ClutterX11TexturePixmap *texture);

    Resets the texture's pixmap from its window, perhaps in response to the pixmap's invalidation as the window changed size.

    +

    +

    automatic :

    TRUE for automatic window updates, FALSE for manual. + TRUE for automatic window updates, FALSE for manual.
    @@ -891,16 +1024,26 @@

    clutter_x11_texture_pixmap_update_area ()

    -
    void                clutter_x11_texture_pixmap_update_area
    -                                                        (ClutterX11TexturePixmap *texture,
    -                                                         gint x,
    -                                                         gint y,
    -                                                         gint width,
    -                                                         gint height);
    +
    void                clutter_x11_texture_pixmap_update_area
    +                                                        (ClutterX11TexturePixmap *texture,
    +                                                         gint x,
    +                                                         gint y,
    +                                                         gint width,
    +                                                         gint height);

    Performs the actual binding of texture to the current content of the pixmap. Can be called to update the texture if the pixmap content has changed.

    +

    +

    @@ -936,12 +1079,16 @@

    clutter_x11_texture_pixmap_set_automatic ()

    -
    void                clutter_x11_texture_pixmap_set_automatic
    -                                                        (ClutterX11TexturePixmap *texture,
    -                                                         gboolean setting);
    +
    void                clutter_x11_texture_pixmap_set_automatic
    +                                                        (ClutterX11TexturePixmap *texture,
    +                                                         gboolean setting);

    Enables or disables the automatic updates ot texture in case the backing pixmap or window is damaged

    +

    +

    @@ -952,7 +1099,7 @@ - @@ -963,6 +1110,6 @@ + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/clutter-animations.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/clutter-animations.html @@ -8,7 +8,7 @@ - + @@ -95,7 +95,9 @@

    Basic Animations

    The most basic way to create animations with Clutter is via the use - of g_timeout_add(). This enables a callback function to be called at a + of g_timeout_add(). This enables a callback function to be called at a defined interval. The callback function can then modify actors visual properties as to produce an animation.

    @@ -152,14 +154,16 @@

    Priorities

    -

    G_PRIORITY_DEFAULT should always be used as the timeouts priority - (in case of g_timeout_add_full()) as not to intefere with Clutter's +

    G_PRIORITY_DEFAULT should always be used as the timeouts priority + (in case of g_timeout_add_full()) as not to intefere with Clutter's scheduling of repaints and input event handling.

    + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/clutter-GLX-Specific-Support.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/clutter-GLX-Specific-Support.html @@ -8,7 +8,7 @@ - + @@ -62,8 +62,8 @@

    setting :

    TRUE to enable automatic updates + TRUE to enable automatic updates
    Top -  |  - Description +  |  + Description
    @@ -77,15 +77,18 @@
    @@ -96,6 +99,8 @@

    The ClutterGLX API is available since Clutter 0.4

    +

    +

    Details

    @@ -106,6 +111,8 @@

    The ClutterGLXTexturePixmap structure contains only private data

    +

    +

    Since 0.8


    @@ -116,14 +123,18 @@

    The ClutterGLXTexturePixmapClass structure contains only private data

    +

    +

    Since 0.8


    clutter_glx_texture_pixmap_new ()

    -
    ClutterActor *      clutter_glx_texture_pixmap_new      (void);
    +
    ClutterActor *      clutter_glx_texture_pixmap_new      (void);

    Creates a new, empty ClutterGLXTexturePixmap

    +

    +

    @@ -138,10 +149,12 @@

    clutter_glx_texture_pixmap_new_with_pixmap ()

    -
    ClutterActor *      clutter_glx_texture_pixmap_new_with_pixmap
    -                                                        (Pixmap pixmap);
    +
    ClutterActor *      clutter_glx_texture_pixmap_new_with_pixmap
    +                                                        (Pixmap pixmap);

    Creates a new ClutterGLXTexturePixmap for pixmap

    +

    +

    @@ -163,10 +176,12 @@

    clutter_glx_texture_pixmap_new_with_window ()

    -
    ClutterActor *      clutter_glx_texture_pixmap_new_with_window
    -                                                        (Window window);
    +
    ClutterActor *      clutter_glx_texture_pixmap_new_with_window
    +                                                        (Window window);

    Creates a new ClutterGLXTexturePixmap for window

    +

    +

    @@ -188,13 +203,17 @@

    clutter_glx_texture_pixmap_using_extension ()

    -
    gboolean            clutter_glx_texture_pixmap_using_extension
    -                                                        (ClutterGLXTexturePixmap *texture);
    +
    gboolean            clutter_glx_texture_pixmap_using_extension
    +                                                        (ClutterGLXTexturePixmap *texture);

    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.

    +

    +

    @@ -205,7 +224,7 @@ - - + - + @@ -154,6 +158,6 @@ + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/annotation-glossary.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/annotation-glossary.html @@ -8,7 +8,7 @@ - + @@ -52,76 +52,83 @@ -

    Returns :

    TRUE if the texture is using the + TRUE if the texture is using the GLX_EXT_texture_from_pixmap OpenGL extension or falling back to the slower software mechanism. @@ -219,6 +238,6 @@ + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/clutterobjectindex.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/clutterobjectindex.html @@ -8,7 +8,7 @@ - + @@ -141,11 +141,15 @@
    ClutterTimelineGInitiallyUnownedGInitiallyUnowned GInterface
    GObjectGObject    
    - + - - - +

    Annotation Glossary

    -

    O

    +
    +

    A

    +
    +
    +array zero-terminated=1
    +

    +
    +
    +
    +

    O

    +
    out
    -

    Parameter for returning results. Default is transfer full.

    -

    A

    +

    Parameter for returning results. Default is transfer-full.

    +
    +
    +
    +

    A

    +
    allow-none
    -

    NULL is ok, both for passing and for returning.

    -

    I

    +

    +
    +
    +
    +

    I

    +
    inout
    -

    Parameter for input and for returning results. Default is transfer full.

    -

    T

    -
    -transfer none
    -

    Don't free data after the code is done.

    -

    A

    +

    Parameter for input and for returning results. Default is transfer-full.

    +
    +
    +
    +

    A

    +
    array

    Parameter points to an array of items.

    -

    E

    +
    +
    +
    +

    E

    +
    element-type

    Generics and defining elements of containers and arrays.

    -

    T

    -
    -transfer container
    -

    Free data container after the code is done.

    -

    I

    +
    +
    +
    +

    T

    +
    +
    +transfer
    +

    +
    +
    +
    +

    I

    +
    in
    -

    Parameter for input. Default is transfer none.

    -

    T

    -
    -transfer full
    -

    Free data after the code is done.

    +

    Parameter for input. Default is transfer-none.

    +
    +
    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ClutterScript.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ClutterScript.html @@ -8,7 +8,7 @@ - + @@ -62,12 +62,12 @@ Top -  |  - Description -  |  - Object Hierarchy -  |  - Properties +  |  + Description +  |  + Object Hierarchy +  |  + Properties
    @@ -81,63 +81,128 @@

    Synopsis

    -
                        ClutterScript;
    +
    +                    ClutterScript;
                         ClutterScriptClass;
    -ClutterScript *     clutter_script_new                  (void);
    +ClutterScript *     clutter_script_new                  (void);
     enum                ClutterScriptError;
    -guint               clutter_script_load_from_data       (ClutterScript *script,
    -                                                         const gchar *data,
    -                                                         gssize length,
    -                                                         GError **error);
    -guint               clutter_script_load_from_file       (ClutterScript *script,
    -                                                         const gchar *filename,
    -                                                         GError **error);
    -void                clutter_script_add_search_paths     (ClutterScript *script,
    -                                                         const gchar * const paths[],
    -                                                         gsize n_paths);
    -gchar *             clutter_script_lookup_filename      (ClutterScript *script,
    -                                                         const gchar *filename);
    -
    -GObject *           clutter_script_get_object           (ClutterScript *script,
    -                                                         const gchar *name);
    -gint                clutter_script_get_objects          (ClutterScript *script,
    -                                                         const gchar *first_name,
    +guint               clutter_script_load_from_data       (ClutterScript *script,
    +                                                         const gchar *data,
    +                                                         gssize length,
    +                                                         GError **error);
    +guint               clutter_script_load_from_file       (ClutterScript *script,
    +                                                         const gchar *filename,
    +                                                         GError **error);
    +void                clutter_script_add_search_paths     (ClutterScript *script,
    +                                                         const gchar * const paths[],
    +                                                         gsize n_paths);
    +gchar *             clutter_script_lookup_filename      (ClutterScript *script,
    +                                                         const gchar *filename);
    +
    +GObject *           clutter_script_get_object           (ClutterScript *script,
    +                                                         const gchar *name);
    +gint                clutter_script_get_objects          (ClutterScript *script,
    +                                                         const gchar *first_name,
                                                              ...);
    -void                clutter_script_unmerge_objects      (ClutterScript *script,
    -                                                         guint merge_id);
    -void                clutter_script_ensure_objects       (ClutterScript *script);
    -GList *             clutter_script_list_objects         (ClutterScript *script);
    -
    -void                (*ClutterScriptConnectFunc)         (ClutterScript *script,
    -                                                         GObject *object,
    -                                                         const gchar *signal_name,
    -                                                         const gchar *handler_name,
    -                                                         GObject *connect_object,
    -                                                         GConnectFlags flags,
    -                                                         gpointer user_data);
    -void                clutter_script_connect_signals      (ClutterScript *script,
    -                                                         gpointer user_data);
    -void                clutter_script_connect_signals_full (ClutterScript *script,
    -                                                         ClutterScriptConnectFunc func,
    -                                                         gpointer user_data);
    -
    -GType               clutter_script_get_type_from_name   (ClutterScript *script,
    -                                                         const gchar *type_name);
    -const gchar *       clutter_get_script_id               (GObject *gobject);
    +void                clutter_script_unmerge_objects      (ClutterScript *script,
    +                                                         guint merge_id);
    +void                clutter_script_ensure_objects       (ClutterScript *script);
    +GList *             clutter_script_list_objects         (ClutterScript *script);
    +
    +void                (*ClutterScriptConnectFunc)         (ClutterScript *script,
    +                                                         GObject *object,
    +                                                         const gchar *signal_name,
    +                                                         const gchar *handler_name,
    +                                                         GObject *connect_object,
    +                                                         GConnectFlags flags,
    +                                                         gpointer user_data);
    +void                clutter_script_connect_signals      (ClutterScript *script,
    +                                                         gpointer user_data);
    +void                clutter_script_connect_signals_full (ClutterScript *script,
    +                                                         ClutterScriptConnectFunc func,
    +                                                         gpointer user_data);
    +
    +GType               clutter_script_get_type_from_name   (ClutterScript *script,
    +                                                         const gchar *type_name);
    +const gchar *       clutter_get_script_id               (GObject *gobject);
     

    Object Hierarchy

    -  GObject
    +  GObject
        +----ClutterScript
     

    Properties

    -  "filename"                 gchar*                : Read
    -  "filename-set"             gboolean              : Read
    +  "filename"                 gchar*                : Read
    +  "filename-set"             gboolean              : Read
     
    @@ -160,7 +225,9 @@ A ClutterScript holds a reference on every object it creates from the definition data, except for the stage. Every non-actor object will be finalized when the ClutterScript instance holding it will -be finalized, so they need to be referenced using g_object_ref() in +be finalized, so they need to be referenced using g_object_ref() in order for them to survive.

    @@ -300,9 +367,13 @@

    Signal handler definitions must have a "name" and a "handler" members; they can also have the "after" and "swapped" boolean members (for the -signal connection flags G_CONNECT_AFTER and G_CONNECT_SWAPPED +signal connection flags G_CONNECT_AFTER and G_CONNECT_SWAPPED respectively) and the "object" string member for calling -g_signal_connect_object() instead of g_signal_connect(). +g_signal_connect_object() instead of g_signal_connect().

    Clutter reserves the following names, so classes defining properties @@ -327,6 +398,8 @@

    ClutterScript is available since Clutter 0.6

    +

    +

    Details

    @@ -336,6 +409,8 @@

    The ClutterScript structure contains only private data and should be accessed using the provided API

    +

    +

    Since 0.6


    @@ -348,14 +423,22 @@

    The ClutterScriptClass structure contains only private data

    +

    +

    - +

    get_type_from_name ()

    get_type_from_name ()

    virtual function used to map a type name - to a GType. This function should only be overridden by - language bindings in order to map native types to GType. - The default implementation is equivalent to g_type_from_name() + to a GType. This function should only be overridden by + language bindings in order to map native types to GType. + The default implementation is equivalent to g_type_from_name()
    @@ -364,19 +447,23 @@

    clutter_script_new ()

    -
    ClutterScript *     clutter_script_new                  (void);
    +
    ClutterScript *     clutter_script_new                  (void);

    Creates a new ClutterScript instance. ClutterScript can be used to load objects definitions for scenegraph elements, like actors, or behavioural elements, like behaviours and timelines. The definitions must be encoded using the JavaScript Object Notation (JSON) language.

    +

    +

    @@ -394,22 +481,24 @@

    ClutterScript error enumeration.

    +

    +

    Returns :

    the newly created ClutterScript instance. Use - g_object_unref() when done. + g_object_unref() when done.
    - + - + - + @@ -420,13 +509,23 @@

    clutter_script_load_from_data ()

    -
    guint               clutter_script_load_from_data       (ClutterScript *script,
    -                                                         const gchar *data,
    -                                                         gssize length,
    -                                                         GError **error);
    +
    guint               clutter_script_load_from_data       (ClutterScript *script,
    +                                                         const gchar *data,
    +                                                         gssize length,
    +                                                         GError **error);

    Loads the definitions from data into script and merges with the currently loaded ones, if any.

    +

    +

    CLUTTER_SCRIPT_ERROR_INVALID_TYPE_FUNCTION

    CLUTTER_SCRIPT_ERROR_INVALID_TYPE_FUNCTION

    Type function not found or invalid

    CLUTTER_SCRIPT_ERROR_INVALID_PROPERTY

    CLUTTER_SCRIPT_ERROR_INVALID_PROPERTY

    Property not found or invalid

    CLUTTER_SCRIPT_ERROR_INVALID_VALUE

    CLUTTER_SCRIPT_ERROR_INVALID_VALUE

    Invalid value
    @@ -448,7 +547,9 @@ - @@ -466,12 +567,20 @@

    clutter_script_load_from_file ()

    -
    guint               clutter_script_load_from_file       (ClutterScript *script,
    -                                                         const gchar *filename,
    -                                                         GError **error);
    +
    guint               clutter_script_load_from_file       (ClutterScript *script,
    +                                                         const gchar *filename,
    +                                                         GError **error);

    Loads the definitions from filename into script and merges with the currently loaded ones, if any.

    +

    +

    error :

    return location for a GError, or NULL + return location for a GError, or NULL
    @@ -487,7 +596,9 @@ - @@ -505,9 +616,13 @@

    clutter_script_add_search_paths ()

    -
    void                clutter_script_add_search_paths     (ClutterScript *script,
    -                                                         const gchar * const paths[],
    -                                                         gsize n_paths);
    +
    void                clutter_script_add_search_paths     (ClutterScript *script,
    +                                                         const gchar * const paths[],
    +                                                         gsize n_paths);

    Adds paths to the list of search paths held by script.

    @@ -515,6 +630,8 @@ The search paths are used by clutter_script_lookup_filename(), which can be used to define search paths for the textures source file name or other custom, file-based properties.

    +

    +

    error :

    return location for a GError, or NULL + return location for a GError, or NULL
    @@ -540,11 +657,17 @@

    clutter_script_lookup_filename ()

    -
    gchar *             clutter_script_lookup_filename      (ClutterScript *script,
    -                                                         const gchar *filename);
    +
    gchar *             clutter_script_lookup_filename      (ClutterScript *script,
    +                                                         const gchar *filename);

    Looks up filename inside the search paths of script. If filename is found, its full path will be returned .

    +

    +

    @@ -560,7 +683,7 @@ - @@ -572,11 +695,17 @@

    clutter_script_get_object ()

    -
    GObject *           clutter_script_get_object           (ClutterScript *script,
    -                                                         const gchar *name);
    +
    GObject *           clutter_script_get_object           (ClutterScript *script,
    +                                                         const gchar *name);

    Retrieves the object bound to name. This function does not increment the reference count of the returned object.

    +

    +

    Returns :

    the full path of filename or NULL if no path was + the full path of filename or NULL if no path was found.
    @@ -592,7 +721,7 @@ - +

    Returns :

    transfer none. transfer none. transfer none. transfer none.
    @@ -601,12 +730,16 @@

    clutter_script_get_objects ()

    -
    gint                clutter_script_get_objects          (ClutterScript *script,
    -                                                         const gchar *first_name,
    +
    gint                clutter_script_get_objects          (ClutterScript *script,
    +                                                         const gchar *first_name,
                                                              ...);

    Retrieves a list of objects for the given names. After script, object -names/return location pairs should be listed, with a NULL pointer +names/return location pairs should be listed, with a NULL pointer ending the list, like:

    @@ -625,6 +758,8 @@

    Note: This function does not increment the reference count of the returned objects.

    +

    +

    @@ -640,8 +775,10 @@ - @@ -657,10 +794,14 @@

    clutter_script_unmerge_objects ()

    -
    void                clutter_script_unmerge_objects      (ClutterScript *script,
    -                                                         guint merge_id);
    +
    void                clutter_script_unmerge_objects      (ClutterScript *script,
    +                                                         guint merge_id);

    Unmerges the objects identified by merge_id.

    +

    +

    ... :

    return location for a GObject, then additional names, ending - with NULL + return location for a GObject, then additional names, ending + with NULL
    @@ -681,10 +822,12 @@

    clutter_script_ensure_objects ()

    -
    void                clutter_script_ensure_objects       (ClutterScript *script);
    +
    void                clutter_script_ensure_objects       (ClutterScript *script);

    Ensure that every object defined inside script is correctly constructed. You should rarely need to use this function.

    +

    +

    @@ -698,13 +841,17 @@

    clutter_script_list_objects ()

    -
    GList *             clutter_script_list_objects         (ClutterScript *script);
    +
    GList *             clutter_script_list_objects         (ClutterScript *script);

    Retrieves all the objects created by script.

    Note: this function does not increment the reference count of the objects it returns.

    +

    +

    @@ -715,7 +862,7 @@ - +

    Returns :

    transfer container) (element-type GObject. transfer container. element-type GObject. transfer container) (element-type GObject. transfer container. element-type GObject.
    @@ -724,18 +871,32 @@

    ClutterScriptConnectFunc ()

    -
    void                (*ClutterScriptConnectFunc)         (ClutterScript *script,
    -                                                         GObject *object,
    -                                                         const gchar *signal_name,
    -                                                         const gchar *handler_name,
    -                                                         GObject *connect_object,
    -                                                         GConnectFlags flags,
    -                                                         gpointer user_data);
    +
    void                (*ClutterScriptConnectFunc)         (ClutterScript *script,
    +                                                         GObject *object,
    +                                                         const gchar *signal_name,
    +                                                         const gchar *handler_name,
    +                                                         GObject *connect_object,
    +                                                         GConnectFlags flags,
    +                                                         gpointer user_data);

    This is the signature of a function used to connect signals. It is used by the clutter_script_connect_signals_full() function. It is mainly intended for interpreted language bindings, but could be useful where the programmer wants more control over the signal connection process.

    +

    +

    @@ -761,7 +922,7 @@ - @@ -781,20 +942,28 @@

    clutter_script_connect_signals ()

    -
    void                clutter_script_connect_signals      (ClutterScript *script,
    -                                                         gpointer user_data);
    +
    void                clutter_script_connect_signals      (ClutterScript *script,
    +                                                         gpointer user_data);

    Connects all the signals defined into a UI definition file to their handlers.

    This method invokes clutter_script_connect_signals_full() internally -and uses GModule's introspective features (by opening the current +and uses GModule's introspective features (by opening the current module's scope) to look at the application's symbol table.

    -Note that this function will not work if GModule is not supported by +Note that this function will not work if GModule is not supported by the platform Clutter is running on.

    +

    +

    connect_object :

    the object to connect the signal to, or NULL + the object to connect the signal to, or NULL
    @@ -805,7 +974,7 @@ - @@ -815,9 +984,11 @@

    clutter_script_connect_signals_full ()

    -
    void                clutter_script_connect_signals_full (ClutterScript *script,
    -                                                         ClutterScriptConnectFunc func,
    -                                                         gpointer user_data);
    +
    void                clutter_script_connect_signals_full (ClutterScript *script,
    +                                                         ClutterScriptConnectFunc func,
    +                                                         gpointer user_data);

    Connects all the signals defined into a UI definition file to their handlers. @@ -830,6 +1001,8 @@

    Applications should use clutter_script_connect_signals().

    +

    +

    user_data :

    data to be passed to the signal handlers, or NULL + data to be passed to the signal handlers, or NULL
    @@ -845,7 +1018,7 @@ - @@ -855,12 +1028,18 @@

    clutter_script_get_type_from_name ()

    -
    GType               clutter_script_get_type_from_name   (ClutterScript *script,
    -                                                         const gchar *type_name);
    +
    GType               clutter_script_get_type_from_name   (ClutterScript *script,
    +                                                         const gchar *type_name);

    Looks up a type by name, using the virtual function that ClutterScript has for that purpose. This function should rarely be used.

    +

    +

    user_data :

    data to be passed to the signal handlers, or NULL + data to be passed to the signal handlers, or NULL
    @@ -877,7 +1056,7 @@ @@ -888,20 +1067,28 @@

    clutter_get_script_id ()

    -
    const gchar *       clutter_get_script_id               (GObject *gobject);
    +
    const gchar *       clutter_get_script_id               (GObject *gobject);

    Retrieves the Clutter script id, if any.

    +

    +

    Returns :

    the type for the requested type name, or - G_TYPE_INVALID if not corresponding type was found. + G_TYPE_INVALID if not corresponding type was found.
    - -

    gobject :

    a GObject + a GObject

    Returns :

    the script id, or NULL if object was not defined inside + the script id, or NULL if object was not defined inside a UI definition file. The returned string is owned by the object and should never be modified or freed. @@ -916,28 +1103,36 @@

    Property Details

    The "filename" property

    -
      "filename"                 gchar*                : Read
    +
      "filename"                 gchar*                : Read

    The path of the currently parsed file. If "filename-set" -is FALSE then the value of this property is undefined.

    +is FALSE then the value of this property is undefined.

    +

    +

    Default value: NULL

    -

    Since 0.6

    +

    Since 0.6


    The "filename-set" property

    -
      "filename-set"             gboolean              : Read
    +
      "filename-set"             gboolean              : Read

    Whether the "filename" property is set. If this property -is TRUE then the currently parsed data comes from a file, and the +is TRUE then the currently parsed data comes from a file, and the file name is stored inside the "filename" property.

    +

    +

    Default value: FALSE

    -

    Since 0.6

    +

    Since 0.6

    + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ch04.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ch04.html @@ -8,7 +8,7 @@ - + @@ -61,7 +61,7 @@

    -Layout managers

    +Layout managers
    ClutterFixedLayout — A fixed layout manager @@ -79,6 +79,6 @@
    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ClutterModel.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ClutterModel.html @@ -8,7 +8,7 @@ - + @@ -62,16 +62,16 @@ Top -  |  - Description -  |  - Object Hierarchy -  |  - Implemented Interfaces -  |  - Properties -  |  - Signals +  |  + Description +  |  + Object Hierarchy +  |  + Implemented Interfaces +  |  + Properties +  |  + Signals
    @@ -85,90 +85,185 @@

    Synopsis

    -
                        ClutterModel;
    +
    +                    ClutterModel;
                         ClutterModelClass;
    -void                clutter_model_set_names             (ClutterModel *model,
    -                                                         guint n_columns,
    -                                                         const gchar * const names[]);
    -void                clutter_model_set_types             (ClutterModel *model,
    -                                                         guint n_columns,
    -                                                         GType *types);
    -const gchar *       clutter_model_get_column_name       (ClutterModel *model,
    -                                                         guint column);
    -GType               clutter_model_get_column_type       (ClutterModel *model,
    -                                                         guint column);
    -guint               clutter_model_get_n_columns         (ClutterModel *model);
    -guint               clutter_model_get_n_rows            (ClutterModel *model);
    +void                clutter_model_set_names             (ClutterModel *model,
    +                                                         guint n_columns,
    +                                                         const gchar * const names[]);
    +void                clutter_model_set_types             (ClutterModel *model,
    +                                                         guint n_columns,
    +                                                         GType *types);
    +const gchar *       clutter_model_get_column_name       (ClutterModel *model,
    +                                                         guint column);
    +GType               clutter_model_get_column_type       (ClutterModel *model,
    +                                                         guint column);
    +guint               clutter_model_get_n_columns         (ClutterModel *model);
    +guint               clutter_model_get_n_rows            (ClutterModel *model);
     
    -void                clutter_model_append                (ClutterModel *model,
    +void                clutter_model_append                (ClutterModel *model,
                                                              ...);
    -void                clutter_model_appendv               (ClutterModel *model,
    -                                                         guint n_columns,
    -                                                         guint *columns,
    -                                                         GValue *values);
    -void                clutter_model_prepend               (ClutterModel *model,
    +void                clutter_model_appendv               (ClutterModel *model,
    +                                                         guint n_columns,
    +                                                         guint *columns,
    +                                                         GValue *values);
    +void                clutter_model_prepend               (ClutterModel *model,
                                                              ...);
    -void                clutter_model_prependv              (ClutterModel *model,
    -                                                         guint n_columns,
    -                                                         guint *columns,
    -                                                         GValue *values);
    -void                clutter_model_insert                (ClutterModel *model,
    -                                                         guint row,
    +void                clutter_model_prependv              (ClutterModel *model,
    +                                                         guint n_columns,
    +                                                         guint *columns,
    +                                                         GValue *values);
    +void                clutter_model_insert                (ClutterModel *model,
    +                                                         guint row,
                                                              ...);
    -void                clutter_model_insertv               (ClutterModel *model,
    -                                                         guint row,
    -                                                         guint n_columns,
    -                                                         guint *columns,
    -                                                         GValue *values);
    -void                clutter_model_insert_value          (ClutterModel *model,
    -                                                         guint row,
    -                                                         guint column,
    -                                                         const GValue *value);
    -void                clutter_model_remove                (ClutterModel *model,
    -                                                         guint row);
    -
    -gboolean            (*ClutterModelForeachFunc)          (ClutterModel *model,
    -                                                         ClutterModelIter *iter,
    -                                                         gpointer user_data);
    -void                clutter_model_foreach               (ClutterModel *model,
    -                                                         ClutterModelForeachFunc func,
    -                                                         gpointer user_data);
    -void                clutter_model_set_sorting_column    (ClutterModel *model,
    -                                                         gint column);
    -gint                clutter_model_get_sorting_column    (ClutterModel *model);
    -gint                (*ClutterModelSortFunc)             (ClutterModel *model,
    -                                                         const GValue *a,
    -                                                         const GValue *b,
    -                                                         gpointer user_data);
    -void                clutter_model_set_sort              (ClutterModel *model,
    -                                                         guint column,
    -                                                         ClutterModelSortFunc func,
    -                                                         gpointer user_data,
    -                                                         GDestroyNotify notify);
    -void                clutter_model_resort                (ClutterModel *model);
    -gboolean            (*ClutterModelFilterFunc)           (ClutterModel *model,
    -                                                         ClutterModelIter *iter,
    -                                                         gpointer user_data);
    -void                clutter_model_set_filter            (ClutterModel *model,
    -                                                         ClutterModelFilterFunc func,
    -                                                         gpointer user_data,
    -                                                         GDestroyNotify notify);
    -gboolean            clutter_model_get_filter_set        (ClutterModel *model);
    -gboolean            clutter_model_filter_iter           (ClutterModel *model,
    -                                                         ClutterModelIter *iter);
    -gboolean            clutter_model_filter_row            (ClutterModel *model,
    -                                                         guint row);
    -
    -ClutterModelIter *  clutter_model_get_first_iter        (ClutterModel *model);
    -ClutterModelIter *  clutter_model_get_last_iter         (ClutterModel *model);
    -ClutterModelIter *  clutter_model_get_iter_at_row       (ClutterModel *model,
    -                                                         guint row);
    +void                clutter_model_insertv               (ClutterModel *model,
    +                                                         guint row,
    +                                                         guint n_columns,
    +                                                         guint *columns,
    +                                                         GValue *values);
    +void                clutter_model_insert_value          (ClutterModel *model,
    +                                                         guint row,
    +                                                         guint column,
    +                                                         const GValue *value);
    +void                clutter_model_remove                (ClutterModel *model,
    +                                                         guint row);
    +
    +gboolean            (*ClutterModelForeachFunc)          (ClutterModel *model,
    +                                                         ClutterModelIter *iter,
    +                                                         gpointer user_data);
    +void                clutter_model_foreach               (ClutterModel *model,
    +                                                         ClutterModelForeachFunc func,
    +                                                         gpointer user_data);
    +void                clutter_model_set_sorting_column    (ClutterModel *model,
    +                                                         gint column);
    +gint                clutter_model_get_sorting_column    (ClutterModel *model);
    +gint                (*ClutterModelSortFunc)             (ClutterModel *model,
    +                                                         const GValue *a,
    +                                                         const GValue *b,
    +                                                         gpointer user_data);
    +void                clutter_model_set_sort              (ClutterModel *model,
    +                                                         guint column,
    +                                                         ClutterModelSortFunc func,
    +                                                         gpointer user_data,
    +                                                         GDestroyNotify notify);
    +void                clutter_model_resort                (ClutterModel *model);
    +gboolean            (*ClutterModelFilterFunc)           (ClutterModel *model,
    +                                                         ClutterModelIter *iter,
    +                                                         gpointer user_data);
    +void                clutter_model_set_filter            (ClutterModel *model,
    +                                                         ClutterModelFilterFunc func,
    +                                                         gpointer user_data,
    +                                                         GDestroyNotify notify);
    +gboolean            clutter_model_get_filter_set        (ClutterModel *model);
    +gboolean            clutter_model_filter_iter           (ClutterModel *model,
    +                                                         ClutterModelIter *iter);
    +gboolean            clutter_model_filter_row            (ClutterModel *model,
    +                                                         guint row);
    +
    +ClutterModelIter *  clutter_model_get_first_iter        (ClutterModel *model);
    +ClutterModelIter *  clutter_model_get_last_iter         (ClutterModel *model);
    +ClutterModelIter *  clutter_model_get_iter_at_row       (ClutterModel *model,
    +                                                         guint row);
     

    Object Hierarchy

    -  GObject
    +  GObject
        +----ClutterModel
              +----ClutterListModel
     
    @@ -182,7 +277,9 @@

    Properties

    -  "filter-set"               gboolean              : Read
    +  "filter-set"               gboolean              : Read
     
    @@ -253,7 +350,7 @@ the same.

    -Iterating a ClutterModel: +Iterating a ""

     enum
    @@ -324,6 +421,8 @@
     

    ClutterModel is available since Clutter 0.6

    +

    +

    Details

    @@ -334,6 +433,8 @@ Base class for list models. The ClutterModel structure contains only private data and should be manipulated using the provided API.

    +

    +

    Since 0.6


    @@ -370,77 +471,79 @@

    Class for ClutterModel instances.

    +

    +

    - + - + - + - + - + - + - + - + - + - + - + - + - + @@ -451,16 +554,22 @@

    clutter_model_set_names ()

    -
    void                clutter_model_set_names             (ClutterModel *model,
    -                                                         guint n_columns,
    -                                                         const gchar * const names[]);
    +
    void                clutter_model_set_names             (ClutterModel *model,
    +                                                         guint n_columns,
    +                                                         const gchar * const names[]);

    Assigns a name to the columns of a ClutterModel.

    -This function is meant primarily for GObjects that inherit from +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.

    +

    +

    get_n_rows ()

    get_n_rows ()

    virtual function for returning the number of rows of the model

    get_n_columns ()

    get_n_columns ()

    virtual function for retuning the number of columns of the model

    get_column_name ()

    get_column_name ()

    virtual function for returning the name of a column

    get_column_type ()

    get_column_type ()

    virtual function for returning the type of a column

    insert_row ()

    insert_row ()

    virtual function for inserting a row at the given index and returning an iterator pointing to it; if the index is a negative integer, the row should be appended to the model

    remove_row ()

    remove_row ()

    virtual function for removing a row at the given index

    get_iter_at_row ()

    get_iter_at_row ()

    virtual function for returning an iterator for the given row

    resort ()

    resort ()

    virtual function for sorting the model using the passed sorting function

    row_added ()

    row_added ()

    signal class handler for ClutterModel::row-added

    row_removed ()

    row_removed ()

    signal class handler for ClutterModel::row-removed

    row_changed ()

    row_changed ()

    signal class handler for ClutterModel::row-changed

    sort_changed ()

    sort_changed ()

    signal class handler for ClutterModel::sort-changed

    filter_changed ()

    filter_changed ()

    signal class handler for ClutterModel::filter-changed
    @@ -485,16 +594,22 @@

    clutter_model_set_types ()

    -
    void                clutter_model_set_types             (ClutterModel *model,
    -                                                         guint n_columns,
    -                                                         GType *types);
    +
    void                clutter_model_set_types             (ClutterModel *model,
    +                                                         guint n_columns,
    +                                                         GType *types);

    Sets the types of the columns inside a ClutterModel.

    -This function is meant primarily for GObjects that inherit from +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.

    +

    +

    @@ -510,7 +625,9 @@ - +

    types :

    an array of GType types. array length=n_columns. an array of GType types. array length=n_columns.
    @@ -519,10 +636,16 @@

    clutter_model_get_column_name ()

    -
    const gchar *       clutter_model_get_column_name       (ClutterModel *model,
    -                                                         guint column);
    +
    const gchar *       clutter_model_get_column_name       (ClutterModel *model,
    +                                                         guint column);

    Retrieves the name of the column

    +

    +

    @@ -550,10 +673,16 @@

    clutter_model_get_column_type ()

    -
    GType               clutter_model_get_column_type       (ClutterModel *model,
    -                                                         guint column);
    +
    GType               clutter_model_get_column_type       (ClutterModel *model,
    +                                                         guint column);

    Retrieves the type of the column.

    +

    +

    @@ -580,9 +709,13 @@

    clutter_model_get_n_columns ()

    -
    guint               clutter_model_get_n_columns         (ClutterModel *model);
    +
    guint               clutter_model_get_n_columns         (ClutterModel *model);

    Retrieves the number of columns inside model.

    +

    +

    @@ -604,10 +737,14 @@

    clutter_model_get_n_rows ()

    -
    guint               clutter_model_get_n_rows            (ClutterModel *model);
    +
    guint               clutter_model_get_n_rows            (ClutterModel *model);

    Retrieves the number of rows inside model, eventually taking into account any filtering function set using clutter_model_set_filter().

    +

    +

    @@ -630,12 +767,12 @@

    clutter_model_append ()

    -
    void                clutter_model_append                (ClutterModel *model,
    +
    void                clutter_model_append                (ClutterModel *model,
                                                              ...);

    Creates and appends a new row to the ClutterModel, setting the row values upon creation. For example, to append a new row where -column 0 is type G_TYPE_INT and column 1 is of type G_TYPE_STRING: +column 0 is type G_TYPE_INT and column 1 is of type G_TYPE_STRING:

    @@ -646,6 +783,8 @@ G_TYPE_STRING, "Team"); clutter_model_append (model, 0, 42, 1, "Team 1", -1);
    +

    +

    @@ -666,13 +805,21 @@

    clutter_model_appendv ()

    -
    void                clutter_model_appendv               (ClutterModel *model,
    -                                                         guint n_columns,
    -                                                         guint *columns,
    -                                                         GValue *values);
    +
    void                clutter_model_appendv               (ClutterModel *model,
    +                                                         guint n_columns,
    +                                                         guint *columns,
    +                                                         GValue *values);

    Creates and appends a new row to the ClutterModel, setting the row values for the given columns upon creation.

    +

    +

    @@ -701,12 +848,12 @@

    clutter_model_prepend ()

    -
    void                clutter_model_prepend               (ClutterModel *model,
    +
    void                clutter_model_prepend               (ClutterModel *model,
                                                              ...);

    Creates and prepends a new row to the ClutterModel, setting the row values upon creation. For example, to prepend a new row where column 0 -is type G_TYPE_INT and column 1 is of type G_TYPE_STRING: +is type G_TYPE_INT and column 1 is of type G_TYPE_STRING:

    @@ -717,6 +864,8 @@ G_TYPE_STRING, "Team"); clutter_model_prepend (model, 0, 42, 1, "Team 1", -1);
    +

    +

    @@ -737,13 +886,21 @@

    clutter_model_prependv ()

    -
    void                clutter_model_prependv              (ClutterModel *model,
    -                                                         guint n_columns,
    -                                                         guint *columns,
    -                                                         GValue *values);
    +
    void                clutter_model_prependv              (ClutterModel *model,
    +                                                         guint n_columns,
    +                                                         guint *columns,
    +                                                         GValue *values);

    Creates and prepends a new row to the ClutterModel, setting the row values for the given columns upon creation.

    +

    +

    @@ -772,14 +929,16 @@

    clutter_model_insert ()

    -
    void                clutter_model_insert                (ClutterModel *model,
    -                                                         guint row,
    +
    void                clutter_model_insert                (ClutterModel *model,
    +                                                         guint row,
                                                              ...);

    Inserts a new row to the ClutterModel at row, setting the row values upon creation. For example, to insert a new row at index 100, -where column 0 is type G_TYPE_INT and column 1 is of type -G_TYPE_STRING: +where column 0 is type G_TYPE_INT and column 1 is of type +G_TYPE_STRING:

    @@ -790,6 +949,8 @@ G_TYPE_STRING, "Team"); clutter_model_insert (model, 3, 0, 42, 1, "Team 1", -1);
    +

    +

    @@ -815,14 +976,24 @@

    clutter_model_insertv ()

    -
    void                clutter_model_insertv               (ClutterModel *model,
    -                                                         guint row,
    -                                                         guint n_columns,
    -                                                         guint *columns,
    -                                                         GValue *values);
    +
    void                clutter_model_insertv               (ClutterModel *model,
    +                                                         guint row,
    +                                                         guint n_columns,
    +                                                         guint *columns,
    +                                                         GValue *values);

    Inserts data at row into the ClutterModel, setting the row values for the given columns upon creation.

    +

    +

    @@ -856,14 +1027,22 @@

    clutter_model_insert_value ()

    -
    void                clutter_model_insert_value          (ClutterModel *model,
    -                                                         guint row,
    -                                                         guint column,
    -                                                         const GValue *value);
    +
    void                clutter_model_insert_value          (ClutterModel *model,
    +                                                         guint row,
    +                                                         guint column,
    +                                                         const GValue *value);

    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.

    +

    +

    @@ -894,10 +1073,14 @@

    clutter_model_remove ()

    -
    void                clutter_model_remove                (ClutterModel *model,
    -                                                         guint row);
    +
    void                clutter_model_remove                (ClutterModel *model,
    +                                                         guint row);

    Removes the row at the given position from the model.

    +

    +

    @@ -918,11 +1101,17 @@

    ClutterModelForeachFunc ()

    -
    gboolean            (*ClutterModelForeachFunc)          (ClutterModel *model,
    -                                                         ClutterModelIter *iter,
    -                                                         gpointer user_data);
    +
    gboolean            (*ClutterModelForeachFunc)          (ClutterModel *model,
    +                                                         ClutterModelIter *iter,
    +                                                         gpointer user_data);

    Iterates on the content of a row in the model

    +

    +

    @@ -943,7 +1132,7 @@ - @@ -954,11 +1143,15 @@

    clutter_model_foreach ()

    -
    void                clutter_model_foreach               (ClutterModel *model,
    -                                                         ClutterModelForeachFunc func,
    -                                                         gpointer user_data);
    +
    void                clutter_model_foreach               (ClutterModel *model,
    +                                                         ClutterModelForeachFunc func,
    +                                                         gpointer user_data);

    Calls func for each row in the model.

    +

    +

    Returns :

    TRUE if the iteration should continue, FALSE otherwise + TRUE if the iteration should continue, FALSE otherwise
    @@ -984,11 +1177,15 @@

    clutter_model_set_sorting_column ()

    -
    void                clutter_model_set_sorting_column    (ClutterModel *model,
    -                                                         gint column);
    +
    void                clutter_model_set_sorting_column    (ClutterModel *model,
    +                                                         gint column);

    Sets the model to sort by column. If column is a negative value the sorting column will be unset.

    +

    +

    @@ -1009,9 +1206,13 @@

    clutter_model_get_sorting_column ()

    -
    gint                clutter_model_get_sorting_column    (ClutterModel *model);
    +
    gint                clutter_model_get_sorting_column    (ClutterModel *model);

    Retrieves the number of column used for sorting the model.

    +

    +

    @@ -1033,12 +1234,22 @@

    ClutterModelSortFunc ()

    -
    gint                (*ClutterModelSortFunc)             (ClutterModel *model,
    -                                                         const GValue *a,
    -                                                         const GValue *b,
    -                                                         gpointer user_data);
    +
    gint                (*ClutterModelSortFunc)             (ClutterModel *model,
    +                                                         const GValue *a,
    +                                                         const GValue *b,
    +                                                         gpointer user_data);

    Compares the content of two rows in the model.

    +

    +

    @@ -1049,12 +1260,16 @@ - - @@ -1076,13 +1291,21 @@

    clutter_model_set_sort ()

    -
    void                clutter_model_set_sort              (ClutterModel *model,
    -                                                         guint column,
    -                                                         ClutterModelSortFunc func,
    -                                                         gpointer user_data,
    -                                                         GDestroyNotify notify);
    +
    void                clutter_model_set_sort              (ClutterModel *model,
    +                                                         guint column,
    +                                                         ClutterModelSortFunc func,
    +                                                         gpointer user_data,
    +                                                         GDestroyNotify notify);

    Sorts model using the given sorting function.

    +

    +

    a :

    a GValue representing the contents of the row + a GValue representing the contents of the row

    b :

    a GValue representing the contents of the second row + a GValue representing the contents of the second row
    @@ -1098,17 +1321,17 @@ - - - @@ -1118,10 +1341,12 @@

    clutter_model_resort ()

    -
    void                clutter_model_resort                (ClutterModel *model);
    +
    void                clutter_model_resort                (ClutterModel *model);

    Force a resort on the model. This function should only be used by subclasses of ClutterModel.

    +

    +

    func :

    a ClutterModelSortFunc, or NULL + a ClutterModelSortFunc, or NULL

    user_data :

    user data to pass to func, or NULL + user data to pass to func, or NULL

    notify :

    destroy notifier of user_data, or NULL + destroy notifier of user_data, or NULL
    @@ -1135,11 +1360,17 @@

    ClutterModelFilterFunc ()

    -
    gboolean            (*ClutterModelFilterFunc)           (ClutterModel *model,
    -                                                         ClutterModelIter *iter,
    -                                                         gpointer user_data);
    +
    gboolean            (*ClutterModelFilterFunc)           (ClutterModel *model,
    +                                                         ClutterModelIter *iter,
    +                                                         gpointer user_data);

    Filters the content of a row in the model.

    +

    +

    @@ -1160,7 +1391,7 @@ - @@ -1171,12 +1402,18 @@

    clutter_model_set_filter ()

    -
    void                clutter_model_set_filter            (ClutterModel *model,
    -                                                         ClutterModelFilterFunc func,
    -                                                         gpointer user_data,
    -                                                         GDestroyNotify notify);
    +
    void                clutter_model_set_filter            (ClutterModel *model,
    +                                                         ClutterModelFilterFunc func,
    +                                                         gpointer user_data,
    +                                                         GDestroyNotify notify);

    Filters the model using the given filtering function.

    +

    +

    Returns :

    If the row should be displayed, return TRUE + If the row should be displayed, return TRUE
    @@ -1187,17 +1424,17 @@ - - - @@ -1207,10 +1444,14 @@

    clutter_model_get_filter_set ()

    -
    gboolean            clutter_model_get_filter_set        (ClutterModel *model);
    +
    gboolean            clutter_model_get_filter_set        (ClutterModel *model);

    Returns whether the model has a filter in place, set using clutter_model_set_filter()

    +

    +

    func :

    a ClutterModelFilterFunc, or NULL + a ClutterModelFilterFunc, or NULL

    user_data :

    user data to pass to func, or NULL + user data to pass to func, or NULL

    notify :

    destroy notifier of user_data, or NULL + destroy notifier of user_data, or NULL
    @@ -1221,7 +1462,7 @@ - @@ -1232,14 +1473,18 @@

    clutter_model_filter_iter ()

    -
    gboolean            clutter_model_filter_iter           (ClutterModel *model,
    -                                                         ClutterModelIter *iter);
    +
    gboolean            clutter_model_filter_iter           (ClutterModel *model,
    +                                                         ClutterModelIter *iter);

    Checks whether the row pointer by iter should be filtered or not using the filtering function set on model.

    This function should be used only by subclasses of ClutterModel.

    +

    +

    Returns :

    TRUE if a filter is set + TRUE if a filter is set
    @@ -1255,8 +1500,8 @@ - @@ -1267,14 +1512,20 @@

    clutter_model_filter_row ()

    -
    gboolean            clutter_model_filter_row            (ClutterModel *model,
    -                                                         guint row);
    +
    gboolean            clutter_model_filter_row            (ClutterModel *model,
    +                                                         guint row);

    Checks whether row should be filtered or not using the filtering function set on model.

    This function should be used only by subclasses of ClutterModel.

    +

    +

    Returns :

    TRUE if the row should be displayed, - FALSE otherwise + TRUE if the row should be displayed, + FALSE otherwise
    @@ -1290,8 +1541,8 @@ - @@ -1302,10 +1553,12 @@

    clutter_model_get_first_iter ()

    -
    ClutterModelIter *  clutter_model_get_first_iter        (ClutterModel *model);
    +
    ClutterModelIter *  clutter_model_get_first_iter        (ClutterModel *model);

    Retrieves a ClutterModelIter representing the first non-filtered row in model.

    +

    +

    Returns :

    TRUE if the row should be displayed, - FALSE otherwise + TRUE if the row should be displayed, + FALSE otherwise
    @@ -1316,7 +1569,7 @@ - +

    Returns :

    transfer full. transfer full. transfer full. transfer full.
    @@ -1325,10 +1578,12 @@

    clutter_model_get_last_iter ()

    -
    ClutterModelIter *  clutter_model_get_last_iter         (ClutterModel *model);
    +
    ClutterModelIter *  clutter_model_get_last_iter         (ClutterModel *model);

    Retrieves a ClutterModelIter representing the last non-filtered row in model.

    +

    +

    @@ -1339,7 +1594,7 @@ - +

    Returns :

    transfer full. transfer full. transfer full. transfer full.
    @@ -1348,8 +1603,10 @@

    clutter_model_get_iter_at_row ()

    -
    ClutterModelIter *  clutter_model_get_iter_at_row       (ClutterModel *model,
    -                                                         guint row);
    +
    ClutterModelIter *  clutter_model_get_iter_at_row       (ClutterModel *model,
    +                                                         guint row);

    Retrieves a ClutterModelIter representing the row at the given index.

    @@ -1357,6 +1614,8 @@ If a filter function has been set using clutter_model_set_filter() then the model implementation will return the first non filtered row.

    +

    +

    @@ -1372,7 +1631,7 @@ - +

    Returns :

    transfer full. transfer full. transfer full. transfer full.
    @@ -1383,25 +1642,33 @@

    Property Details

    The "filter-set" property

    -
      "filter-set"               gboolean              : Read
    +
      "filter-set"               gboolean              : Read

    Whether the ClutterModel has a filter set

    -This property is set to TRUE if a filter function has been +This property is set to TRUE if a filter function has been set using clutter_model_set_filter()

    +

    +

    Default value: FALSE

    -

    Since 1.0

    +

    Since 1.0

    Signal Details

    The "filter-changed" signal

    -
    void                user_function                      (ClutterModel *model,
    -                                                        gpointer      user_data)      : Run Last
    +
    void                user_function                      (ClutterModel *model,
    +                                                        gpointer      user_data)      : Run Last

    The ::filter-changed signal is emitted when a new filter has been applied

    +

    +

    @@ -1416,18 +1683,22 @@
    -

    Since 0.6

    +

    Since 0.6


    The "row-added" signal

    -
    void                user_function                      (ClutterModel     *model,
    -                                                        ClutterModelIter *iter,
    -                                                        gpointer          user_data)      : Run Last
    +
    void                user_function                      (ClutterModel     *model,
    +                                                        ClutterModelIter *iter,
    +                                                        gpointer          user_data)      : Run Last

    The ::row-added signal is emitted when a new row has been added. The data on the row has already been set when the ::row-added signal has been emitted.

    +

    +

    @@ -1447,18 +1718,22 @@
    -

    Since 0.6

    +

    Since 0.6


    The "row-changed" signal

    -
    void                user_function                      (ClutterModel     *model,
    -                                                        ClutterModelIter *iter,
    -                                                        gpointer          user_data)      : Run Last
    +
    void                user_function                      (ClutterModel     *model,
    +                                                        ClutterModelIter *iter,
    +                                                        gpointer          user_data)      : Run Last

    The ::row-removed signal is emitted when a row has been changed. The data on the row has already been updated when the ::row-changed signal has been emitted.

    +

    +

    @@ -1478,18 +1753,22 @@
    -

    Since 0.6

    +

    Since 0.6


    The "row-removed" signal

    -
    void                user_function                      (ClutterModel     *model,
    -                                                        ClutterModelIter *iter,
    -                                                        gpointer          user_data)      : Run Last
    +
    void                user_function                      (ClutterModel     *model,
    +                                                        ClutterModelIter *iter,
    +                                                        gpointer          user_data)      : Run Last

    The ::row-removed signal is emitted when a row has been removed. The data on the row pointed by the passed iterator is still valid when the ::row-removed signal has been emitted.

    +

    +

    @@ -1509,15 +1788,19 @@
    -

    Since 0.6

    +

    Since 0.6


    The "sort-changed" signal

    -
    void                user_function                      (ClutterModel *model,
    -                                                        gpointer      user_data)      : Run Last
    +
    void                user_function                      (ClutterModel *model,
    +                                                        gpointer      user_data)      : Run Last

    The ::sort-changed signal is emitted after the model has been sorted

    +

    +

    @@ -1532,12 +1815,12 @@
    -

    Since 0.6

    +

    Since 0.6

    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/clutter.devhelp2 +++ clutter-1.0-1.2.4/doc/reference/clutter/html/clutter.devhelp2 @@ -126,16 +126,16 @@ - - - - - - + + + + + + - + @@ -443,7 +443,7 @@ - + @@ -603,8 +603,8 @@ - - + + @@ -1062,7 +1062,7 @@ - + @@ -1080,8 +1080,8 @@ - - + + @@ -1122,7 +1122,7 @@ - + @@ -1184,13 +1184,13 @@ - + - + - + @@ -1248,7 +1248,7 @@ - + @@ -1259,22 +1259,22 @@ - + - - - - - - - - - - + + + + + + + + + + @@ -1422,175 +1422,175 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/clutterglossary.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/clutterglossary.html @@ -8,7 +8,7 @@ - + @@ -72,6 +72,6 @@
    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ClutterDeviceManager.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ClutterDeviceManager.html @@ -8,7 +8,7 @@ - + @@ -62,14 +62,14 @@ Top -  |  - Description -  |  - Object Hierarchy -  |  - Properties -  |  - Signals +  |  + Description +  |  + Object Hierarchy +  |  + Properties +  |  + Signals
    @@ -83,32 +83,43 @@

    Object Hierarchy

    -  GObject
    +  GObject
        +----ClutterDeviceManager
     

    Properties

    -  "backend"                  ClutterBackend*       : Read / Write / Construct Only
    +  "backend"                  ClutterBackend*       : Read / Write / Construct Only
     
    @@ -132,6 +143,8 @@

    ClutterDeviceManager is available since Clutter 1.2

    +

    +

    Details

    @@ -140,6 +153,8 @@
    typedef struct _ClutterDeviceManager ClutterDeviceManager;

    The ClutterDeviceManager structure contains only private data

    +

    +

    Since 1.2


    @@ -150,20 +165,24 @@

    The ClutterDeviceManagerClass structure contains only private data

    +

    +

    Since 1.2


    clutter_device_manager_get_default ()

    -
    ClutterDeviceManager * clutter_device_manager_get_default
    +
    ClutterDeviceManager * clutter_device_manager_get_default
                                                             (void);

    Retrieves the device manager singleton

    +

    +

    - +

    Returns :

    transfer none. transfer none. transfer none. transfer none.

    Since 1.2

    @@ -171,9 +190,13 @@

    clutter_device_manager_list_devices ()

    -
    GSList *            clutter_device_manager_list_devices (ClutterDeviceManager *device_manager);
    +
    GSList *            clutter_device_manager_list_devices (ClutterDeviceManager *device_manager);

    Lists all currently registered input devices

    +

    +

    @@ -184,7 +207,7 @@ - +

    Returns :

    transfer container) (element-type ClutterInputDevice. transfer container. element-type ClutterInputDevice. transfer container) (element-type ClutterInputDevice. transfer container. element-type ClutterInputDevice.
    @@ -193,9 +216,13 @@

    clutter_device_manager_peek_devices ()

    -
    const GSList *      clutter_device_manager_peek_devices (ClutterDeviceManager *device_manager);
    +
    const GSList *      clutter_device_manager_peek_devices (ClutterDeviceManager *device_manager);

    Lists all currently registered input devices

    +

    +

    @@ -206,7 +233,7 @@ - +

    Returns :

    transfer none) (element-type ClutterInputDevice. transfer none. element-type ClutterInputDevice. transfer none) (element-type ClutterInputDevice. transfer none. element-type ClutterInputDevice.
    @@ -215,10 +242,14 @@

    clutter_device_manager_get_device ()

    -
    ClutterInputDevice * clutter_device_manager_get_device  (ClutterDeviceManager *device_manager,
    -                                                         gint device_id);
    +
    ClutterInputDevice * clutter_device_manager_get_device  (ClutterDeviceManager *device_manager,
    +                                                         gint device_id);

    Retrieves the ClutterInputDevice with the given device_id

    +

    +

    @@ -234,7 +265,7 @@ - +

    Returns :

    transfer none. transfer none. transfer none. transfer none.
    @@ -243,15 +274,17 @@

    clutter_device_manager_get_core_device ()

    -
    ClutterInputDevice * clutter_device_manager_get_core_device
    -                                                        (ClutterDeviceManager *device_manager,
    -                                                         ClutterInputDeviceType device_type);
    +
    ClutterInputDevice * clutter_device_manager_get_core_device
    +                                                        (ClutterDeviceManager *device_manager,
    +                                                         ClutterInputDeviceType device_type);

    Retrieves the core ClutterInputDevice of type device_type

    Core devices are devices created automatically by the default Clutter backend

    +

    +

    @@ -267,7 +300,7 @@ - +

    Returns :

    transfer none. transfer none. transfer none. transfer none.
    @@ -276,7 +309,9 @@

    clutter_get_input_device_for_id ()

    -
    ClutterInputDevice * clutter_get_input_device_for_id    (gint id);
    +
    ClutterInputDevice * clutter_get_input_device_for_id    (gint id);

    Retrieves the ClutterInputDevice from its id. This is a convenience wrapper for clutter_device_manager_get_device() and it is functionally @@ -291,6 +326,8 @@ manager = clutter_device_manager_get_default (); device = clutter_device_manager_get_device (manager, id);

    +

    +

    @@ -301,7 +338,7 @@ - +

    Returns :

    a ClutterInputDevice, or NULL. transfer none. a ClutterInputDevice, or NULL. transfer none.
    @@ -312,7 +349,7 @@

    Property Details

    The "backend" property

    -
      "backend"                  ClutterBackend*       : Read / Write / Construct Only
    +
      "backend"                  ClutterBackend*       : Read / Write / Construct Only

    The ClutterBackend of the device manager.

    @@ -320,12 +357,16 @@

    Signal Details

    The "device-added" signal

    -
    void                user_function                      (ClutterDeviceManager *manager,
    -                                                        ClutterInputDevice   *device,
    -                                                        gpointer              user_data)      : Run Last
    +
    void                user_function                      (ClutterDeviceManager *manager,
    +                                                        ClutterInputDevice   *device,
    +                                                        gpointer              user_data)      : Run Last

    The ::device-added signal is emitted each time a device has been added to the ClutterDeviceManager

    +

    +

    @@ -345,17 +386,21 @@
    -

    Since 1.2

    +

    Since 1.2


    The "device-removed" signal

    -
    void                user_function                      (ClutterDeviceManager *manager,
    -                                                        ClutterInputDevice   *device,
    -                                                        gpointer              user_data)      : Run Last
    +
    void                user_function                      (ClutterDeviceManager *manager,
    +                                                        ClutterInputDevice   *device,
    +                                                        gpointer              user_data)      : Run Last

    The ::device-removed signal is emitted each time a device has been removed from the ClutterDeviceManager

    +

    +

    @@ -375,12 +420,12 @@
    -

    Since 1.2

    +

    Since 1.2

    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ClutterLayoutMeta.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ClutterLayoutMeta.html @@ -8,7 +8,7 @@ - + @@ -62,12 +62,12 @@ Top -  |  - Description -  |  - Object Hierarchy -  |  - Properties +  |  + Description +  |  + Object Hierarchy +  |  + Properties
    @@ -81,15 +81,18 @@

    Object Hierarchy

    -  GObject
    +  GObject
        +----ClutterChildMeta
              +----ClutterLayoutMeta
     
    @@ -97,7 +100,7 @@

    Properties

    -  "manager"                  ClutterLayoutManager*  : Read / Write / Construct Only
    +  "manager"                  ClutterLayoutManager*  : Read / Write / Construct Only
     
    @@ -112,6 +115,8 @@

    ClutterLayoutMeta is available since Clutter 1.2

    +

    +

    Details

    @@ -126,12 +131,14 @@

    A ClutterLayoutManager sub-class should create a ClutterLayoutMeta -instance by overriding the ClutterLayoutManager::create_child_meta() +instance by overriding the ""create_child_meta() virtual function

    +

    +

    - + @@ -147,14 +154,18 @@

    The ClutterLayoutMetaClass contains only private data and should never be accessed directly

    +

    +

    Since 1.2


    clutter_layout_meta_get_manager ()

    -
    ClutterLayoutManager * clutter_layout_meta_get_manager  (ClutterLayoutMeta *data);
    +
    ClutterLayoutManager * clutter_layout_meta_get_manager  (ClutterLayoutMeta *data);

    Retrieves the actor wrapped by data

    +

    +

    ClutterLayoutManager *manager;

    ClutterLayoutManager *manager;

    the layout manager handling this data
    @@ -165,7 +176,7 @@ - +

    Returns :

    a ClutterLayoutManager. transfer none. a ClutterLayoutManager. transfer none.
    @@ -176,15 +187,17 @@

    Property Details

    The "manager" property

    -
      "manager"                  ClutterLayoutManager*  : Read / Write / Construct Only
    +
      "manager"                  ClutterLayoutManager*  : Read / Write / Construct Only

    The ClutterLayoutManager that created this ClutterLayoutMeta.

    -

    Since 1.2

    +

    +

    +

    Since 1.2

    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/clutterbase.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/clutterbase.html @@ -8,7 +8,7 @@ - + @@ -136,6 +136,6 @@
    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/clutter-Key-Bindings.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/clutter-Key-Bindings.html @@ -8,7 +8,7 @@ - + @@ -62,12 +62,12 @@ Top -  |  - Description -  |  - Object Hierarchy -  |  - Properties +  |  + Description +  |  + Object Hierarchy +  |  + Properties
    @@ -81,69 +81,132 @@

    Synopsis

    -
                        ClutterBindingPool;
    -gboolean            (*ClutterBindingActionFunc)         (GObject *gobject,
    -                                                         const gchar *action_name,
    -                                                         guint key_val,
    -                                                         ClutterModifierType modifiers);
    -
    -ClutterBindingPool * clutter_binding_pool_new           (const gchar *name);
    -ClutterBindingPool * clutter_binding_pool_get_for_class (gpointer klass);
    -ClutterBindingPool * clutter_binding_pool_find          (const gchar *name);
    -
    -void                clutter_binding_pool_install_action (ClutterBindingPool *pool,
    -                                                         const gchar *action_name,
    -                                                         guint key_val,
    -                                                         ClutterModifierType modifiers,
    -                                                         GCallback callback,
    -                                                         gpointer data,
    -                                                         GDestroyNotify notify);
    -void                clutter_binding_pool_install_closure
    -                                                        (ClutterBindingPool *pool,
    -                                                         const gchar *action_name,
    -                                                         guint key_val,
    -                                                         ClutterModifierType modifiers,
    -                                                         GClosure *closure);
    -void                clutter_binding_pool_override_action
    -                                                        (ClutterBindingPool *pool,
    -                                                         guint key_val,
    -                                                         ClutterModifierType modifiers,
    -                                                         GCallback callback,
    -                                                         gpointer data,
    -                                                         GDestroyNotify notify);
    -void                clutter_binding_pool_override_closure
    -                                                        (ClutterBindingPool *pool,
    -                                                         guint key_val,
    -                                                         ClutterModifierType modifiers,
    -                                                         GClosure *closure);
    -const gchar *       clutter_binding_pool_find_action    (ClutterBindingPool *pool,
    -                                                         guint key_val,
    -                                                         ClutterModifierType modifiers);
    -void                clutter_binding_pool_remove_action  (ClutterBindingPool *pool,
    -                                                         guint key_val,
    -                                                         ClutterModifierType modifiers);
    -void                clutter_binding_pool_block_action   (ClutterBindingPool *pool,
    -                                                         const gchar *action_name);
    -void                clutter_binding_pool_unblock_action (ClutterBindingPool *pool,
    -                                                         const gchar *action_name);
    -
    -gboolean            clutter_binding_pool_activate       (ClutterBindingPool *pool,
    -                                                         guint key_val,
    -                                                         ClutterModifierType modifiers,
    -                                                         GObject *gobject);
    +
    +                    ClutterBindingPool;
    +gboolean            (*ClutterBindingActionFunc)         (GObject *gobject,
    +                                                         const gchar *action_name,
    +                                                         guint key_val,
    +                                                         ClutterModifierType modifiers);
    +
    +ClutterBindingPool * clutter_binding_pool_new           (const gchar *name);
    +ClutterBindingPool * clutter_binding_pool_get_for_class (gpointer klass);
    +ClutterBindingPool * clutter_binding_pool_find          (const gchar *name);
    +
    +void                clutter_binding_pool_install_action (ClutterBindingPool *pool,
    +                                                         const gchar *action_name,
    +                                                         guint key_val,
    +                                                         ClutterModifierType modifiers,
    +                                                         GCallback callback,
    +                                                         gpointer data,
    +                                                         GDestroyNotify notify);
    +void                clutter_binding_pool_install_closure
    +                                                        (ClutterBindingPool *pool,
    +                                                         const gchar *action_name,
    +                                                         guint key_val,
    +                                                         ClutterModifierType modifiers,
    +                                                         GClosure *closure);
    +void                clutter_binding_pool_override_action
    +                                                        (ClutterBindingPool *pool,
    +                                                         guint key_val,
    +                                                         ClutterModifierType modifiers,
    +                                                         GCallback callback,
    +                                                         gpointer data,
    +                                                         GDestroyNotify notify);
    +void                clutter_binding_pool_override_closure
    +                                                        (ClutterBindingPool *pool,
    +                                                         guint key_val,
    +                                                         ClutterModifierType modifiers,
    +                                                         GClosure *closure);
    +const gchar *       clutter_binding_pool_find_action    (ClutterBindingPool *pool,
    +                                                         guint key_val,
    +                                                         ClutterModifierType modifiers);
    +void                clutter_binding_pool_remove_action  (ClutterBindingPool *pool,
    +                                                         guint key_val,
    +                                                         ClutterModifierType modifiers);
    +void                clutter_binding_pool_block_action   (ClutterBindingPool *pool,
    +                                                         const gchar *action_name);
    +void                clutter_binding_pool_unblock_action (ClutterBindingPool *pool,
    +                                                         const gchar *action_name);
    +
    +gboolean            clutter_binding_pool_activate       (ClutterBindingPool *pool,
    +                                                         guint key_val,
    +                                                         ClutterModifierType modifiers,
    +                                                         GObject *gobject);
     

    Object Hierarchy

    -  GObject
    +  GObject
        +----ClutterBindingPool
     

    Properties

    -  "name"                     gchar*                : Read / Write / Construct Only
    +  "name"                     gchar*                : Read / Write / Construct Only
     
    @@ -224,13 +287,15 @@

    -The clutter_binding_pool_activate() function will return FALSE if +The clutter_binding_pool_activate() function will return FALSE if no action for the given key binding was found, if the action was blocked (using clutter_binding_pool_block_action()) or if the -key binding handler returned FALSE. +key binding handler returned FALSE.

    ClutterBindingPool is available since Clutter 1.0

    +

    +

    Details

    @@ -240,25 +305,39 @@

    Container of key bindings. The ClutterBindingPool struct is private.

    +

    +

    Since 1.0


    ClutterBindingActionFunc ()

    -
    gboolean            (*ClutterBindingActionFunc)         (GObject *gobject,
    -                                                         const gchar *action_name,
    -                                                         guint key_val,
    -                                                         ClutterModifierType modifiers);
    +
    gboolean            (*ClutterBindingActionFunc)         (GObject *gobject,
    +                                                         const gchar *action_name,
    +                                                         guint key_val,
    +                                                         ClutterModifierType modifiers);

    The prototype for the callback function registered with clutter_binding_pool_install_action() and invoked by clutter_binding_pool_activate().

    +

    +

    - @@ -278,8 +357,8 @@ - @@ -290,12 +369,16 @@

    clutter_binding_pool_new ()

    -
    ClutterBindingPool * clutter_binding_pool_new           (const gchar *name);
    +
    ClutterBindingPool * clutter_binding_pool_new           (const gchar *name);

    Creates a new ClutterBindingPool that can be used to store key bindings for an actor. The name must be a unique identifier for the binding pool, so that clutter_binding_pool_find() will be able to return the correct binding pool.

    +

    +

    gobject :

    a GObject + a GObject

    Returns :

    the function should return TRUE if the key - binding has been handled, and return FALSE otherwise + the function should return TRUE if the key + binding has been handled, and return FALSE otherwise
    @@ -307,7 +390,9 @@ @@ -318,9 +403,13 @@

    clutter_binding_pool_get_for_class ()

    -
    ClutterBindingPool * clutter_binding_pool_get_for_class (gpointer klass);
    -

    -Retrieves the ClutterBindingPool for the given GObject class +

    ClutterBindingPool * clutter_binding_pool_get_for_class (gpointer klass);
    +

    +Retrieves the ClutterBindingPool for the given GObject class and, eventually, creates it. This function is a wrapper around clutter_binding_pool_new() and uses the class type name as the unique name for the binding pool. @@ -338,17 +427,21 @@

       pool = clutter_binding_pool_find (G_OBJECT_TYPE_NAME (instance));
     
    +

    +

    Returns :

    the newly created binding pool with the given - name. Use g_object_unref() when done. + name. Use g_object_unref() when done.
    - - +

    klass :

    a GObjectClass pointer + a GObjectClass pointer

    Returns :

    transfer none. transfer none. transfer none. transfer none.
    @@ -357,9 +450,13 @@

    clutter_binding_pool_find ()

    -
    ClutterBindingPool * clutter_binding_pool_find          (const gchar *name);
    +
    ClutterBindingPool * clutter_binding_pool_find          (const gchar *name);

    Finds the ClutterBindingPool with name.

    +

    +

    @@ -370,7 +467,7 @@ - +

    Returns :

    a pointer to the ClutterBindingPool, or NULL. transfer none. a pointer to the ClutterBindingPool, or NULL. transfer none.
    @@ -379,13 +476,23 @@

    clutter_binding_pool_install_action ()

    -
    void                clutter_binding_pool_install_action (ClutterBindingPool *pool,
    -                                                         const gchar *action_name,
    -                                                         guint key_val,
    -                                                         ClutterModifierType modifiers,
    -                                                         GCallback callback,
    -                                                         gpointer data,
    -                                                         GDestroyNotify notify);
    +
    void                clutter_binding_pool_install_action (ClutterBindingPool *pool,
    +                                                         const gchar *action_name,
    +                                                         guint key_val,
    +                                                         ClutterModifierType modifiers,
    +                                                         GCallback callback,
    +                                                         gpointer data,
    +                                                         GDestroyNotify notify);

    Installs a new action inside a ClutterBindingPool. The action is bound to key_val and modifiers. @@ -401,6 +508,8 @@

    Actions can be blocked with clutter_binding_pool_block_action() and then unblocked using clutter_binding_pool_unblock_action().

    +

    +

    @@ -447,14 +556,22 @@

    clutter_binding_pool_install_closure ()

    -
    void                clutter_binding_pool_install_closure
    -                                                        (ClutterBindingPool *pool,
    -                                                         const gchar *action_name,
    -                                                         guint key_val,
    -                                                         ClutterModifierType modifiers,
    -                                                         GClosure *closure);
    -

    -A GClosure variant of clutter_binding_pool_install_action(). +

    void                clutter_binding_pool_install_closure
    +                                                        (ClutterBindingPool *pool,
    +                                                         const gchar *action_name,
    +                                                         guint key_val,
    +                                                         ClutterModifierType modifiers,
    +                                                         GClosure *closure);
    +

    +A GClosure variant of clutter_binding_pool_install_action().

    Installs a new action inside a ClutterBindingPool. The action @@ -471,6 +588,8 @@

    Actions can be blocked with clutter_binding_pool_block_action() and then unblocked using clutter_binding_pool_unblock_action().

    +

    +

    @@ -496,7 +615,9 @@ - @@ -506,13 +627,21 @@

    clutter_binding_pool_override_action ()

    -
    void                clutter_binding_pool_override_action
    -                                                        (ClutterBindingPool *pool,
    -                                                         guint key_val,
    -                                                         ClutterModifierType modifiers,
    -                                                         GCallback callback,
    -                                                         gpointer data,
    -                                                         GDestroyNotify notify);
    +
    void                clutter_binding_pool_override_action
    +                                                        (ClutterBindingPool *pool,
    +                                                         guint key_val,
    +                                                         ClutterModifierType modifiers,
    +                                                         GCallback callback,
    +                                                         gpointer data,
    +                                                         GDestroyNotify notify);

    Allows overriding the action for key_val and modifiers inside a ClutterBindingPool. See clutter_binding_pool_install_action(). @@ -524,6 +653,8 @@

    Actions can be blocked with clutter_binding_pool_block_action() and then unblocked using clutter_binding_pool_unblock_action().

    +

    +

    closure :

    a GClosure + a GClosure
    @@ -565,13 +696,19 @@

    clutter_binding_pool_override_closure ()

    -
    void                clutter_binding_pool_override_closure
    -                                                        (ClutterBindingPool *pool,
    -                                                         guint key_val,
    -                                                         ClutterModifierType modifiers,
    -                                                         GClosure *closure);
    -

    -A GClosure variant of clutter_binding_pool_override_action(). +

    void                clutter_binding_pool_override_closure
    +                                                        (ClutterBindingPool *pool,
    +                                                         guint key_val,
    +                                                         ClutterModifierType modifiers,
    +                                                         GClosure *closure);
    +

    +A GClosure variant of clutter_binding_pool_override_action().

    Allows overriding the action for key_val and modifiers inside a @@ -584,6 +721,8 @@

    Actions can be blocked with clutter_binding_pool_block_action() and then unblocked using clutter_binding_pool_unblock_action().

    +

    +

    @@ -604,7 +743,9 @@ - @@ -614,12 +755,18 @@

    clutter_binding_pool_find_action ()

    -
    const gchar *       clutter_binding_pool_find_action    (ClutterBindingPool *pool,
    -                                                         guint key_val,
    -                                                         ClutterModifierType modifiers);
    +
    const gchar *       clutter_binding_pool_find_action    (ClutterBindingPool *pool,
    +                                                         guint key_val,
    +                                                         ClutterModifierType modifiers);

    Retrieves the name of the action matching the given key symbol and modifiers bitmask.

    +

    +

    closure :

    a GClosure + a GClosure
    @@ -640,7 +787,7 @@ -

    Returns :

    the name of the action, if found, or NULL. The + 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 @@ -653,12 +800,16 @@

    clutter_binding_pool_remove_action ()

    -
    void                clutter_binding_pool_remove_action  (ClutterBindingPool *pool,
    -                                                         guint key_val,
    -                                                         ClutterModifierType modifiers);
    +
    void                clutter_binding_pool_remove_action  (ClutterBindingPool *pool,
    +                                                         guint key_val,
    +                                                         ClutterModifierType modifiers);

    Removes the action matching the given key_val, modifiers pair, if any exists.

    +

    +

    @@ -684,10 +835,14 @@

    clutter_binding_pool_block_action ()

    -
    void                clutter_binding_pool_block_action   (ClutterBindingPool *pool,
    -                                                         const gchar *action_name);
    +
    void                clutter_binding_pool_block_action   (ClutterBindingPool *pool,
    +                                                         const gchar *action_name);

    Blocks all the actions with name action_name inside pool.

    +

    +

    @@ -708,8 +863,10 @@

    clutter_binding_pool_unblock_action ()

    -
    void                clutter_binding_pool_unblock_action (ClutterBindingPool *pool,
    -                                                         const gchar *action_name);
    +
    void                clutter_binding_pool_unblock_action (ClutterBindingPool *pool,
    +                                                         const gchar *action_name);

    Unblockes all the actions with name action_name inside pool.

    @@ -717,6 +874,8 @@ Unblocking an action does not cause the callback bound to it to be invoked in case clutter_binding_pool_activate() was called on an action previously blocked with clutter_binding_pool_block_action().

    +

    +

    @@ -737,10 +896,16 @@

    clutter_binding_pool_activate ()

    -
    gboolean            clutter_binding_pool_activate       (ClutterBindingPool *pool,
    -                                                         guint key_val,
    -                                                         ClutterModifierType modifiers,
    -                                                         GObject *gobject);
    +
    gboolean            clutter_binding_pool_activate       (ClutterBindingPool *pool,
    +                                                         guint key_val,
    +                                                         ClutterModifierType modifiers,
    +                                                         GObject *gobject);

    Activates the callback associated to the action that is bound to the key_val and modifiers pair. @@ -760,14 +925,18 @@

    -Where the GObject instance is gobject and the user data +Where the GObject instance is gobject and the user data is the one passed when installing the action with clutter_binding_pool_install_action().

    If the action bound to the key_val, modifiers pair has been blocked using clutter_binding_pool_block_action(), the callback -will not be invoked, and this function will return FALSE.

    +will not be invoked, and this function will return FALSE.

    +

    +

    @@ -788,12 +957,14 @@ - - @@ -806,16 +977,20 @@

    Property Details

    The "name" property

    -
      "name"                     gchar*                : Read / Write / Construct Only
    +
      "name"                     gchar*                : Read / Write / Construct Only

    The unique name of the ClutterBindingPool.

    +

    +

    Default value: NULL

    -

    Since 1.0

    +

    Since 1.0

    + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/clutterobjecthierarchy.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/clutterobjecthierarchy.html @@ -8,7 +8,7 @@ - + @@ -63,8 +63,12 @@

    Object Hierarchy

    -    GObject
    -        GInitiallyUnowned
    +    GObject
    +        GInitiallyUnowned
                 ClutterActor
                     ClutterGroup
                         ClutterStage
    @@ -113,6 +117,6 @@
     
     
    +          Generated by GTK-Doc V1.11
     
    -
    \ No newline at end of file
    +
    --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/clutter-General.html
    +++ clutter-1.0-1.2.4/doc/reference/clutter/html/clutter-General.html
    @@ -8,7 +8,7 @@
     
     
     
    -
    +
     
     
     
    @@ -62,8 +62,8 @@
     
     

    gobject :

    a GObject + a GObject

    Returns :

    TRUE if an action was found and was activated + TRUE if an action was found and was activated
    Top -  |  - Description +  |  + Description
    @@ -77,86 +77,189 @@

    Synopsis

    -
    #define             CLUTTER_PRIORITY_REDRAW
    +
    +#define             CLUTTER_PRIORITY_REDRAW
     
     enum                ClutterInitError;
    -ClutterInitError    clutter_init                        (int *argc,
    -                                                         char ***argv);
    -ClutterInitError    clutter_init_with_args              (int *argc,
    -                                                         char ***argv,
    -                                                         const char *parameter_string,
    -                                                         GOptionEntry *entries,
    -                                                         const char *translation_domain,
    -                                                         GError **error);
    -GOptionGroup *      clutter_get_option_group            (void);
    -GOptionGroup *      clutter_get_option_group_without_init
    +ClutterInitError    clutter_init                        (int *argc,
    +                                                         char ***argv);
    +ClutterInitError    clutter_init_with_args              (int *argc,
    +                                                         char ***argv,
    +                                                         const char *parameter_string,
    +                                                         GOptionEntry *entries,
    +                                                         const char *translation_domain,
    +                                                         GError **error);
    +GOptionGroup *      clutter_get_option_group            (void);
    +GOptionGroup *      clutter_get_option_group_without_init
                                                             (void);
     
    -void                clutter_main                        (void);
    -void                clutter_main_quit                   (void);
    -gint                clutter_main_level                  (void);
    -
    -gboolean            clutter_get_debug_enabled           (void);
    -gboolean            clutter_get_show_fps                (void);
    -gulong              clutter_get_timestamp               (void);
    -ClutterActor *      clutter_get_actor_by_gid            (guint32 id);
    -void                clutter_set_default_frame_rate      (guint frames_per_sec);
    -guint               clutter_get_default_frame_rate      (void);
    -void                clutter_set_motion_events_enabled   (gboolean enable);
    -gboolean            clutter_get_motion_events_enabled   (void);
    -void                clutter_clear_glyph_cache           (void);
    +void                clutter_main                        (void);
    +void                clutter_main_quit                   (void);
    +gint                clutter_main_level                  (void);
    +
    +gboolean            clutter_get_debug_enabled           (void);
    +gboolean            clutter_get_show_fps                (void);
    +gulong              clutter_get_timestamp               (void);
    +ClutterActor *      clutter_get_actor_by_gid            (guint32 id);
    +void                clutter_set_default_frame_rate      (guint frames_per_sec);
    +guint               clutter_get_default_frame_rate      (void);
    +void                clutter_set_motion_events_enabled   (gboolean enable);
    +gboolean            clutter_get_motion_events_enabled   (void);
    +void                clutter_clear_glyph_cache           (void);
     enum                ClutterFontFlags;
    -void                clutter_set_font_flags              (ClutterFontFlags flags);
    -ClutterFontFlags    clutter_get_font_flags              (void);
    -PangoFontMap *      clutter_get_font_map                (void);
    +void                clutter_set_font_flags              (ClutterFontFlags flags);
    +ClutterFontFlags    clutter_get_font_flags              (void);
    +PangoFontMap *      clutter_get_font_map                (void);
     enum                ClutterTextDirection;
    -ClutterTextDirection  clutter_get_default_text_direction
    +ClutterTextDirection  clutter_get_default_text_direction
                                                             (void);
     
    -void                clutter_threads_set_lock_functions  (GCallback enter_fn,
    -                                                         GCallback leave_fn);
    -void                clutter_threads_init                (void);
    -void                clutter_threads_enter               (void);
    -void                clutter_threads_leave               (void);
    -guint               clutter_threads_add_idle            (GSourceFunc func,
    -                                                         gpointer data);
    -guint               clutter_threads_add_idle_full       (gint priority,
    -                                                         GSourceFunc func,
    -                                                         gpointer data,
    -                                                         GDestroyNotify notify);
    -guint               clutter_threads_add_timeout         (guint interval,
    -                                                         GSourceFunc func,
    -                                                         gpointer data);
    -guint               clutter_threads_add_timeout_full    (gint priority,
    -                                                         guint interval,
    -                                                         GSourceFunc func,
    -                                                         gpointer data,
    -                                                         GDestroyNotify notify);
    -guint               clutter_threads_add_frame_source    (guint fps,
    -                                                         GSourceFunc func,
    -                                                         gpointer data);
    -guint               clutter_threads_add_frame_source_full
    -                                                        (gint priority,
    -                                                         guint fps,
    -                                                         GSourceFunc func,
    -                                                         gpointer data,
    -                                                         GDestroyNotify notify);
    -guint               clutter_threads_add_repaint_func    (GSourceFunc func,
    -                                                         gpointer data,
    -                                                         GDestroyNotify notify);
    -void                clutter_threads_remove_repaint_func (guint handle_id);
    -
    -ClutterActor *      clutter_get_keyboard_grab           (void);
    -ClutterActor *      clutter_get_pointer_grab            (void);
    -void                clutter_grab_keyboard               (ClutterActor *actor);
    -void                clutter_grab_pointer                (ClutterActor *actor);
    -void                clutter_ungrab_keyboard             (void);
    -void                clutter_ungrab_pointer              (void);
    -void                clutter_grab_pointer_for_device     (ClutterActor *actor,
    -                                                         gint id);
    -void                clutter_ungrab_pointer_for_device   (gint id);
    +void                clutter_threads_set_lock_functions  (GCallback enter_fn,
    +                                                         GCallback leave_fn);
    +void                clutter_threads_init                (void);
    +void                clutter_threads_enter               (void);
    +void                clutter_threads_leave               (void);
    +guint               clutter_threads_add_idle            (GSourceFunc func,
    +                                                         gpointer data);
    +guint               clutter_threads_add_idle_full       (gint priority,
    +                                                         GSourceFunc func,
    +                                                         gpointer data,
    +                                                         GDestroyNotify notify);
    +guint               clutter_threads_add_timeout         (guint interval,
    +                                                         GSourceFunc func,
    +                                                         gpointer data);
    +guint               clutter_threads_add_timeout_full    (gint priority,
    +                                                         guint interval,
    +                                                         GSourceFunc func,
    +                                                         gpointer data,
    +                                                         GDestroyNotify notify);
    +guint               clutter_threads_add_frame_source    (guint fps,
    +                                                         GSourceFunc func,
    +                                                         gpointer data);
    +guint               clutter_threads_add_frame_source_full
    +                                                        (gint priority,
    +                                                         guint fps,
    +                                                         GSourceFunc func,
    +                                                         gpointer data,
    +                                                         GDestroyNotify notify);
    +guint               clutter_threads_add_repaint_func    (GSourceFunc func,
    +                                                         gpointer data,
    +                                                         GDestroyNotify notify);
    +void                clutter_threads_remove_repaint_func (guint handle_id);
    +
    +ClutterActor *      clutter_get_keyboard_grab           (void);
    +ClutterActor *      clutter_get_pointer_grab            (void);
    +void                clutter_grab_keyboard               (ClutterActor *actor);
    +void                clutter_grab_pointer                (ClutterActor *actor);
    +void                clutter_ungrab_keyboard             (void);
    +void                clutter_ungrab_pointer              (void);
    +void                clutter_grab_pointer_for_device     (ClutterActor *actor,
    +                                                         gint id);
    +void                clutter_ungrab_pointer_for_device   (gint id);
     
    -void                clutter_do_event                    (ClutterEvent *event);
    +void                clutter_do_event                    (ClutterEvent *event);
     
    @@ -219,16 +322,22 @@

    The common pattern for using threads with Clutter is to use worker threads to perform blocking operations and then install idle or timeour sources with the result when the thread finished.

    -

    Clutter provides thread-aware variants of g_idle_add() and - g_timeout_add() that acquire the Clutter lock before invoking the provided +

    Clutter provides thread-aware variants of g_idle_add() and + g_timeout_add() that acquire the Clutter lock before invoking the provided callback: clutter_threads_add_idle() and clutter_threads_add_timeout().

    +

    +

    Details

    -

    CLUTTER_PRIORITY_REDRAW

    +

    CLUTTER_PRIORITY_REDRAW

    #define CLUTTER_PRIORITY_REDRAW         (G_PRIORITY_HIGH_IDLE + 50)
     

    @@ -237,6 +346,8 @@ GTK+ and Clutter it's more likely that the Clutter part will be continually animating (and thus able to starve GTK+) than vice-versa.

    +

    +

    Since 0.8


    @@ -252,31 +363,33 @@

    Error conditions returned by clutter_init() and clutter_init_with_args().

    +

    +

    - + - + - + - + - + @@ -287,23 +400,25 @@

    clutter_init ()

    -
    ClutterInitError    clutter_init                        (int *argc,
    -                                                         char ***argv);
    +
    ClutterInitError    clutter_init                        (int *argc,
    +                                                         char ***argv);

    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.

    +

    +

    CLUTTER_INIT_SUCCESS

    CLUTTER_INIT_SUCCESS

    Initialisation successful

    CLUTTER_INIT_ERROR_UNKNOWN

    CLUTTER_INIT_ERROR_UNKNOWN

    Unknown error

    CLUTTER_INIT_ERROR_THREADS

    CLUTTER_INIT_ERROR_THREADS

    Thread initialisation failed

    CLUTTER_INIT_ERROR_BACKEND

    CLUTTER_INIT_ERROR_BACKEND

    Backend initialisation failed

    CLUTTER_INIT_ERROR_INTERNAL

    CLUTTER_INIT_ERROR_INTERNAL

    Internal error
    - + - + @@ -316,12 +431,16 @@

    clutter_init_with_args ()

    -
    ClutterInitError    clutter_init_with_args              (int *argc,
    -                                                         char ***argv,
    -                                                         const char *parameter_string,
    -                                                         GOptionEntry *entries,
    -                                                         const char *translation_domain,
    -                                                         GError **error);
    +
    ClutterInitError    clutter_init_with_args              (int *argc,
    +                                                         char ***argv,
    +                                                         const char *parameter_string,
    +                                                         GOptionEntry *entries,
    +                                                         const char *translation_domain,
    +                                                         GError **error);

    This function does the same work as clutter_init(). Additionally, it allows you to add your own command line options, and it @@ -330,36 +449,40 @@ 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.

    +

    +

    argc :

    The number of arguments in argv. inout. The number of arguments in argv. inout.

    argv :

    array length=argc) (inout) (allow-none. array length=argc. inout length=argc. allow-none length=argc. array length=argc) (inout) (allow-none. array length=argc. inout length=argc. allow-none length=argc.

    Returns :

    - + - + - + - + - + - + -

    argc :

    a pointer to the number of command line arguments. inout. a pointer to the number of command line arguments. inout.

    argv :

    array length=argc) (inout) (allow-none. array length=argc. inout length=argc. allow-none length=argc. array length=argc) (inout) (allow-none. array length=argc. inout length=argc. allow-none length=argc.

    parameter_string :

    allow-none. allow-none. allow-none. allow-none.

    entries :

    allow-none. allow-none. allow-none. allow-none.

    translation_domain :

    allow-none. allow-none. allow-none. allow-none.

    error :

    a return location for a GError. allow-none. a return location for a GError. allow-none.

    Returns :

    CLUTTER_INIT_SUCCESS if Clutter has been successfully + CLUTTER_INIT_SUCCESS if Clutter has been successfully initialised, or other values or ClutterInitError in case of error. @@ -372,15 +495,29 @@

    clutter_get_option_group ()

    -
    GOptionGroup *      clutter_get_option_group            (void);
    -

    -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() +

    GOptionGroup *      clutter_get_option_group            (void);
    +

    +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.

    -Calling g_option_context_parse() with Clutter's GOptionGroup will result +Calling g_option_context_parse() with Clutter's GOptionGroup will result in Clutter's initialization. That is, the following code:

    @@ -402,14 +539,22 @@

    -After g_option_context_parse() on a GOptionContext containing the -Clutter GOptionGroup has returned TRUE, Clutter is guaranteed to be +After g_option_context_parse() on a GOptionContext containing the +Clutter GOptionGroup has returned TRUE, Clutter is guaranteed to be initialized.

    +

    +

    - +

    Returns :

    transfer full. transfer full. transfer full. transfer full.

    Since 0.2

    @@ -417,22 +562,40 @@

    clutter_get_option_group_without_init ()

    -
    GOptionGroup *      clutter_get_option_group_without_init
    +
    GOptionGroup *      clutter_get_option_group_without_init
                                                             (void);

    -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() +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 +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().

    +clutter_x11_set_display(), or with gtk_clutter_init().

    +

    +

    - +

    Returns :

    transfer full. transfer full. transfer full. transfer full.

    Since 0.8.2

    @@ -440,23 +603,31 @@

    clutter_main ()

    -
    void                clutter_main                        (void);
    +
    void                clutter_main                        (void);

    Starts the Clutter mainloop.

    +

    +


    clutter_main_quit ()

    -
    void                clutter_main_quit                   (void);
    +
    void                clutter_main_quit                   (void);

    Terminates the Clutter mainloop.

    +

    +


    clutter_main_level ()

    -
    gint                clutter_main_level                  (void);
    +
    gint                clutter_main_level                  (void);

    Retrieves the depth of the Clutter mainloop.

    +

    +

    @@ -469,9 +640,13 @@

    clutter_get_debug_enabled ()

    -
    gboolean            clutter_get_debug_enabled           (void);
    +
    gboolean            clutter_get_debug_enabled           (void);

    Check if clutter has debugging turned on.

    +

    +

    @@ -484,17 +659,21 @@

    clutter_get_show_fps ()

    -
    gboolean            clutter_get_show_fps                (void);
    +
    gboolean            clutter_get_show_fps                (void);

    Returns whether Clutter should print out the frames per second on the console. You can enable this setting either using the CLUTTER_SHOW_FPS environment variable or passing the --clutter-show-fps command line argument. *

    +

    +

    - @@ -504,10 +683,14 @@

    clutter_get_timestamp ()

    -
    gulong              clutter_get_timestamp               (void);
    +
    gulong              clutter_get_timestamp               (void);

    Returns the approximate number of microseconds passed since clutter was intialised.

    +

    +

    Returns :

    TRUE if Clutter should show the FPS. + TRUE if Clutter should show the FPS.
    @@ -520,9 +703,13 @@

    clutter_get_actor_by_gid ()

    -
    ClutterActor *      clutter_get_actor_by_gid            (guint32 id);
    +
    ClutterActor *      clutter_get_actor_by_gid            (guint32 id);

    Retrieves the ClutterActor with id.

    +

    +

    @@ -533,7 +720,7 @@ - +

    Returns :

    transfer none. transfer none. transfer none. transfer none.
    @@ -542,12 +729,16 @@

    clutter_set_default_frame_rate ()

    -
    void                clutter_set_default_frame_rate      (guint frames_per_sec);
    +
    void                clutter_set_default_frame_rate      (guint frames_per_sec);

    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.

    +

    +

    @@ -561,9 +752,13 @@

    clutter_get_default_frame_rate ()

    -
    guint               clutter_get_default_frame_rate      (void);
    +
    guint               clutter_get_default_frame_rate      (void);

    Retrieves the default frame rate. See clutter_set_default_frame_rate().

    +

    +

    @@ -578,13 +773,15 @@

    clutter_set_motion_events_enabled ()

    -
    void                clutter_set_motion_events_enabled   (gboolean enable);
    +
    void                clutter_set_motion_events_enabled   (gboolean enable);

    Sets whether per-actor motion events should be enabled or not (the default is to enable them).

    -If enable is FALSE the following events will not work: +If enable is FALSE the following events will not work:

    • ClutterActor::motion-event, unless on the @@ -592,11 +789,13 @@

    • ClutterActor::enter-event

    • ClutterActor::leave-event

    +

    +

    -

    enable :

    TRUE to enable per-actor motion events + TRUE to enable per-actor motion events
    @@ -605,14 +804,18 @@

    clutter_get_motion_events_enabled ()

    -
    gboolean            clutter_get_motion_events_enabled   (void);
    +
    gboolean            clutter_get_motion_events_enabled   (void);

    Gets whether the per-actor motion events are enabled.

    +

    +

    - @@ -622,12 +825,14 @@

    clutter_clear_glyph_cache ()

    -
    void                clutter_clear_glyph_cache           (void);
    +
    void                clutter_clear_glyph_cache           (void);

    Clears the internal cache of glyphs used by the Pango renderer. This will free up some memory and GL texture resources. The cache will be automatically refilled as more text is drawn.

    +

    +

    Since 0.8


    @@ -642,16 +847,18 @@

    Runtime flags to change the font quality. To be used with clutter_set_font_flags().

    +

    +

    Returns :

    TRUE if the motion events are enabled + TRUE if the motion events are enabled
    - + - + @@ -662,7 +869,7 @@

    clutter_set_font_flags ()

    -
    void                clutter_set_font_flags              (ClutterFontFlags flags);
    +
    void                clutter_set_font_flags              (ClutterFontFlags flags);

    Sets the font quality options for subsequent text rendering operations. @@ -674,6 +881,8 @@

    Enabling hinting improves text quality for static text but may introduce some artifacts if the text is animated.

    +

    +

    CLUTTER_FONT_MIPMAPPING

    CLUTTER_FONT_MIPMAPPING

    Set to use mipmaps for the glyph cache textures.

    CLUTTER_FONT_HINTING

    CLUTTER_FONT_HINTING

    Set to enable hinting on the glyphs.
    @@ -687,10 +896,12 @@

    clutter_get_font_flags ()

    -
    ClutterFontFlags    clutter_get_font_flags              (void);
    +
    ClutterFontFlags    clutter_get_font_flags              (void);

    Gets the current font flags for rendering text. See clutter_set_font_flags().

    +

    +

    @@ -705,16 +916,22 @@

    clutter_get_font_map ()

    -
    PangoFontMap *      clutter_get_font_map                (void);
    -

    -Retrieves the PangoFontMap instance used by Clutter. +

    PangoFontMap *      clutter_get_font_map                (void);
    +

    +Retrieves the PangoFontMap instance used by Clutter. You can use the global font map object with the COGL Pango API.

    +

    +

    - +

    Returns :

    transfer none. transfer none. transfer none. transfer none.

    Since 1.0

    @@ -730,22 +947,24 @@

    The text direction to be used by ClutterActors

    +

    +

    - + - + - + @@ -756,7 +975,7 @@

    clutter_get_default_text_direction ()

    -
    ClutterTextDirection  clutter_get_default_text_direction
    +
    ClutterTextDirection  clutter_get_default_text_direction
                                                             (void);

    Retrieves the default direction for the text. The text direction is @@ -766,6 +985,8 @@

    The default text direction can be overridden on a per-actor basis by using clutter_actor_set_text_direction()

    +

    +

    CLUTTER_TEXT_DIRECTION_DEFAULT

    CLUTTER_TEXT_DIRECTION_DEFAULT

    Use the default setting, as returned by clutter_get_default_text_direction()

    CLUTTER_TEXT_DIRECTION_LTR

    CLUTTER_TEXT_DIRECTION_LTR

    Use left-to-right text direction

    CLUTTER_TEXT_DIRECTION_RTL

    CLUTTER_TEXT_DIRECTION_RTL

    Use right-to-left text direction
    @@ -780,12 +1001,18 @@

    clutter_threads_set_lock_functions ()

    -
    void                clutter_threads_set_lock_functions  (GCallback enter_fn,
    -                                                         GCallback leave_fn);
    +
    void                clutter_threads_set_lock_functions  (GCallback enter_fn,
    +                                                         GCallback leave_fn);

    Allows the application to replace the standard method that Clutter uses to protect its data structures. Normally, Clutter -creates a single GMutex that is locked by clutter_threads_enter(), +creates a single GMutex that is locked by clutter_threads_enter(), and released by clutter_threads_leave(); using this function an application provides, instead, a function enter_fn that is called by clutter_threads_enter() and a function leave_fn that is @@ -808,6 +1035,8 @@

    This method must be called before clutter_threads_init(), and cannot be called multiple times.

    +

    +

    @@ -828,46 +1057,62 @@

    clutter_threads_init ()

    -
    void                clutter_threads_init                (void);
    +
    void                clutter_threads_init                (void);

    Initialises the Clutter threading mechanism, so that Clutter API can be called by multiple threads, using clutter_threads_enter() and clutter_threads_leave() to mark the critical sections.

    -You must call g_thread_init() before this function. +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


    clutter_threads_enter ()

    -
    void                clutter_threads_enter               (void);
    +
    void                clutter_threads_enter               (void);

    Locks the Clutter thread lock.

    +

    +

    Since 0.4


    clutter_threads_leave ()

    -
    void                clutter_threads_leave               (void);
    +
    void                clutter_threads_leave               (void);

    Unlocks the Clutter thread lock.

    +

    +

    Since 0.4


    clutter_threads_add_idle ()

    -
    guint               clutter_threads_add_idle            (GSourceFunc func,
    -                                                         gpointer data);
    +
    guint               clutter_threads_add_idle            (GSourceFunc func,
    +                                                         gpointer data);

    Simple wrapper around clutter_threads_add_idle_full() using the default priority.

    +

    +

    @@ -894,17 +1139,29 @@

    clutter_threads_add_idle_full ()

    -
    guint               clutter_threads_add_idle_full       (gint priority,
    -                                                         GSourceFunc func,
    -                                                         gpointer data,
    -                                                         GDestroyNotify notify);
    +
    guint               clutter_threads_add_idle_full       (gint priority,
    +                                                         GSourceFunc func,
    +                                                         gpointer data,
    +                                                         GDestroyNotify notify);

    Adds a function to be called whenever there are no higher priority -events pending. If the function returns FALSE it is automatically +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(): +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:

    @@ -986,13 +1243,15 @@ closure, NULL);
    +

    +

    @@ -1023,11 +1282,21 @@

    clutter_threads_add_timeout ()

    -
    guint               clutter_threads_add_timeout         (guint interval,
    -                                                         GSourceFunc func,
    -                                                         gpointer data);
    +
    guint               clutter_threads_add_timeout         (guint interval,
    +                                                         GSourceFunc func,
    +                                                         gpointer data);

    Simple wrapper around clutter_threads_add_timeout_full().

    +

    +

    priority :

    the priority of the timeout source. Typically this will be in the - range between G_PRIORITY_DEFAULT_IDLE and G_PRIORITY_HIGH_IDLE + range between G_PRIORITY_DEFAULT_IDLE and G_PRIORITY_HIGH_IDLE
    @@ -1059,15 +1328,27 @@

    clutter_threads_add_timeout_full ()

    -
    guint               clutter_threads_add_timeout_full    (gint priority,
    -                                                         guint interval,
    -                                                         GSourceFunc func,
    -                                                         gpointer data,
    -                                                         GDestroyNotify notify);
    +
    guint               clutter_threads_add_timeout_full    (gint priority,
    +                                                         guint interval,
    +                                                         GSourceFunc func,
    +                                                         gpointer data,
    +                                                         GDestroyNotify notify);

    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 +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.

    @@ -1083,13 +1364,15 @@

    See also clutter_threads_add_idle_full().

    +

    +

    @@ -1125,11 +1408,21 @@

    clutter_threads_add_frame_source ()

    -
    guint               clutter_threads_add_frame_source    (guint fps,
    -                                                         GSourceFunc func,
    -                                                         gpointer data);
    +
    guint               clutter_threads_add_frame_source    (guint fps,
    +                                                         GSourceFunc func,
    +                                                         gpointer data);

    Simple wrapper around clutter_threads_add_frame_source_full().

    +

    +

    priority :

    the priority of the timeout source. Typically this will be in the - range between G_PRIORITY_DEFAULT and G_PRIORITY_HIGH. + range between G_PRIORITY_DEFAULT and G_PRIORITY_HIGH.
    @@ -1161,16 +1454,28 @@

    clutter_threads_add_frame_source_full ()

    -
    guint               clutter_threads_add_frame_source_full
    -                                                        (gint priority,
    -                                                         guint fps,
    -                                                         GSourceFunc func,
    -                                                         gpointer data,
    -                                                         GDestroyNotify notify);
    +
    guint               clutter_threads_add_frame_source_full
    +                                                        (gint priority,
    +                                                         guint fps,
    +                                                         GSourceFunc func,
    +                                                         gpointer data,
    +                                                         GDestroyNotify notify);

    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 +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.

    @@ -1187,13 +1492,15 @@

    See also clutter_threads_add_idle_full().

    +

    +

    @@ -1229,12 +1536,20 @@

    clutter_threads_add_repaint_func ()

    -
    guint               clutter_threads_add_repaint_func    (GSourceFunc func,
    -                                                         gpointer data,
    -                                                         GDestroyNotify notify);
    +
    guint               clutter_threads_add_repaint_func    (GSourceFunc func,
    +                                                         gpointer data,
    +                                                         GDestroyNotify notify);

    Adds a function to be called whenever Clutter is repainting a Stage. -If the function returns FALSE it is automatically removed from the +If the function returns FALSE it is automatically removed from the list of repaint functions and will not be called again.

    @@ -1247,9 +1562,11 @@ a frame from a video into a ClutterTexture.

    -When the repaint function is removed (either because it returned FALSE +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.

    +

    +

    priority :

    the priority of the frame source. Typically this will be in the - range between G_PRIORITY_DEFAULT and G_PRIORITY_HIGH. + range between G_PRIORITY_DEFAULT and G_PRIORITY_HIGH.
    @@ -1260,13 +1577,13 @@ - @@ -1284,9 +1601,13 @@

    clutter_threads_remove_repaint_func ()

    -
    void                clutter_threads_remove_repaint_func (guint handle_id);
    +
    void                clutter_threads_remove_repaint_func (guint handle_id);

    Removes the repaint function with handle_id as its id

    +

    +

    data :

    data to be passed to the function, or NULL + data to be passed to the function, or NULL

    notify :

    function to be called when removing the repaint - function, or NULL + function, or NULL
    @@ -1300,14 +1621,16 @@

    clutter_get_keyboard_grab ()

    -
    ClutterActor *      clutter_get_keyboard_grab           (void);
    +
    ClutterActor *      clutter_get_keyboard_grab           (void);

    Queries the current keyboard grab of clutter.

    +

    +

    - +

    Returns :

    the actor currently holding the keyboard grab, or NULL if there is no grab.. transfer none. the actor currently holding the keyboard grab, or NULL if there is no grab.. transfer none.

    Since 0.6

    @@ -1315,14 +1638,16 @@

    clutter_get_pointer_grab ()

    -
    ClutterActor *      clutter_get_pointer_grab            (void);
    +
    ClutterActor *      clutter_get_pointer_grab            (void);

    Queries the current pointer grab of clutter.

    +

    +

    - +

    Returns :

    the actor currently holding the pointer grab, or NULL if there is no grab.. transfer none. the actor currently holding the pointer grab, or NULL if there is no grab.. transfer none.

    Since 0.6

    @@ -1330,7 +1655,7 @@

    clutter_grab_keyboard ()

    -
    void                clutter_grab_keyboard               (ClutterActor *actor);
    +
    void                clutter_grab_keyboard               (ClutterActor *actor);

    Grabs keyboard events, after the grab is done keyboard events ("key-press-event" and "key-release-event") @@ -1345,6 +1670,8 @@

    See also clutter_stage_set_key_focus() and clutter_actor_grab_key_focus() to perform a "soft" key grab and assign key focus to a specific actor.

    +

    +

    @@ -1358,7 +1685,7 @@

    clutter_grab_pointer ()

    -
    void                clutter_grab_pointer                (ClutterActor *actor);
    +
    void                clutter_grab_pointer                (ClutterActor *actor);

    Grabs pointer events, after the grab is done all pointer related events (press, motion, release, enter, leave and scroll) are delivered to this @@ -1380,6 +1707,8 @@

    If you wish to grab all the pointer events for a specific input device, you should use clutter_grab_pointer_for_device().

    +

    +

    @@ -1393,29 +1722,37 @@

    clutter_ungrab_keyboard ()

    -
    void                clutter_ungrab_keyboard             (void);
    +
    void                clutter_ungrab_keyboard             (void);

    Removes an existing grab of the keyboard.

    +

    +

    Since 0.6


    clutter_ungrab_pointer ()

    -
    void                clutter_ungrab_pointer              (void);
    +
    void                clutter_ungrab_pointer              (void);

    Removes an existing grab of the pointer.

    +

    +

    Since 0.6


    clutter_grab_pointer_for_device ()

    -
    void                clutter_grab_pointer_for_device     (ClutterActor *actor,
    -                                                         gint id);
    +
    void                clutter_grab_pointer_for_device     (ClutterActor *actor,
    +                                                         gint id);

    Grabs all the pointer events coming from the device id for actor.

    If id is -1 then this function is equivalent to clutter_grab_pointer().

    +

    +

    @@ -1436,9 +1773,13 @@

    clutter_ungrab_pointer_for_device ()

    -
    void                clutter_ungrab_pointer_for_device   (gint id);
    +
    void                clutter_ungrab_pointer_for_device   (gint id);

    Removes an existing grab of the pointer events for device id.

    +

    +

    @@ -1452,9 +1793,11 @@

    clutter_do_event ()

    -
    void                clutter_do_event                    (ClutterEvent *event);
    +
    void                clutter_do_event                    (ClutterEvent *event);

    Processes an event. This function should never be called by applications.

    +

    +

    @@ -1469,6 +1812,6 @@ + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ClutterBinLayout.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ClutterBinLayout.html @@ -8,7 +8,7 @@ - + @@ -62,12 +62,12 @@
    Top -  |  - Description -  |  - Object Hierarchy -  |  - Properties +  |  + Description +  |  + Object Hierarchy +  |  + Properties
    @@ -81,30 +81,35 @@

    Object Hierarchy

    -  GObject
    -   +----GInitiallyUnowned
    +  GObject
    +   +----GInitiallyUnowned
              +----ClutterLayoutManager
                    +----ClutterBinLayout
     
    @@ -112,8 +117,8 @@

    Properties

    -  "x-align"                  ClutterBinAlignment   : Read / Write
    -  "y-align"                  ClutterBinAlignment   : Read / Write
    +  "x-align"                  ClutterBinAlignment   : Read / Write
    +  "y-align"                  ClutterBinAlignment   : Read / Write
     
    @@ -143,7 +148,7 @@

    The image shows a ClutterBinLayout with three layers: a background ClutterCairoTexture, set to fill on both the X and Y axis; a ClutterTexture, set to center on both the X and - Y axis; and a ClutterRectangle, set to CLUTTER_BIN_ALIGNMENT_END + Y axis; and a ClutterRectangle, set to CLUTTER_BIN_ALIGNMENT_END on both the X and Y axis.

    Bin layout
    @@ -192,6 +197,8 @@

    ClutterBinLayout is available since Clutter 1.2

    +

    +

    Details

    @@ -207,35 +214,37 @@

    The alignment policies available on each axis for ClutterBinLayout

    +

    +

    - + - + - + - + - + @@ -251,6 +260,8 @@

    The ClutterBinLayout structure contains only private data and should be accessed using the provided API

    +

    +

    Since 1.2


    @@ -262,15 +273,19 @@

    The ClutterBinLayoutClass structure contains only private data and should be accessed using the provided API

    +

    +

    Since 1.2


    clutter_bin_layout_new ()

    -
    ClutterLayoutManager * clutter_bin_layout_new           (ClutterBinAlignment x_align,
    -                                                         ClutterBinAlignment y_align);
    +
    ClutterLayoutManager * clutter_bin_layout_new           (ClutterBinAlignment x_align,
    +                                                         ClutterBinAlignment y_align);

    Creates a new ClutterBinLayout layout manager

    +

    +

    CLUTTER_BIN_ALIGNMENT_FIXED

    CLUTTER_BIN_ALIGNMENT_FIXED

    Fixed position alignment; the ClutterBinLayout will honour the fixed position provided by the actors themselves when allocating them

    CLUTTER_BIN_ALIGNMENT_FILL

    CLUTTER_BIN_ALIGNMENT_FILL

    Fill the allocation size

    CLUTTER_BIN_ALIGNMENT_START

    CLUTTER_BIN_ALIGNMENT_START

    Position the actors at the top or left side of the container, depending on the axis

    CLUTTER_BIN_ALIGNMENT_END

    CLUTTER_BIN_ALIGNMENT_END

    Position the actors at the bottom or right side of the container, depending on the axis

    CLUTTER_BIN_ALIGNMENT_CENTER

    CLUTTER_BIN_ALIGNMENT_CENTER

    Position the actors at the center of the container, depending on the axis
    @@ -299,17 +314,19 @@

    clutter_bin_layout_set_alignment ()

    -
    void                clutter_bin_layout_set_alignment    (ClutterBinLayout *self,
    -                                                         ClutterActor *child,
    -                                                         ClutterBinAlignment x_align,
    -                                                         ClutterBinAlignment y_align);
    +
    void                clutter_bin_layout_set_alignment    (ClutterBinLayout *self,
    +                                                         ClutterActor *child,
    +                                                         ClutterBinAlignment x_align,
    +                                                         ClutterBinAlignment y_align);

    Sets the horizontal and vertical alignment policies to be applied to a child of self

    -If child is NULL then the x_align and y_align values will +If child is NULL then the x_align and y_align values will be set as the default alignment policies

    +

    +

    @@ -320,7 +337,7 @@ - + @@ -341,17 +358,19 @@

    clutter_bin_layout_get_alignment ()

    -
    void                clutter_bin_layout_get_alignment    (ClutterBinLayout *self,
    -                                                         ClutterActor *child,
    -                                                         ClutterBinAlignment *x_align,
    -                                                         ClutterBinAlignment *y_align);
    +
    void                clutter_bin_layout_get_alignment    (ClutterBinLayout *self,
    +                                                         ClutterActor *child,
    +                                                         ClutterBinAlignment *x_align,
    +                                                         ClutterBinAlignment *y_align);

    Retrieves the horizontal and vertical alignment policies for a child of self

    -If child is NULL the default alignment policies will be returned +If child is NULL the default alignment policies will be returned instead

    +

    +

    child :

    a child of container. allow-none. a child of container. allow-none.

    x_align :

    @@ -362,15 +381,15 @@ - + - + - +

    child :

    a child of container. allow-none. a child of container. allow-none.

    x_align :

    out) (allow-none. out. allow-none. out) (allow-none. out. allow-none.

    y_align :

    out) (allow-none. out. allow-none. out) (allow-none. out. allow-none.
    @@ -379,10 +398,10 @@

    clutter_bin_layout_add ()

    -
    void                clutter_bin_layout_add              (ClutterBinLayout *self,
    -                                                         ClutterActor *child,
    -                                                         ClutterBinAlignment x_align,
    -                                                         ClutterBinAlignment y_align);
    +
    void                clutter_bin_layout_add              (ClutterBinLayout *self,
    +                                                         ClutterActor *child,
    +                                                         ClutterBinAlignment x_align,
    +                                                         ClutterBinAlignment y_align);

    Adds a ClutterActor to the container using self and sets the alignment policies for it @@ -392,6 +411,8 @@ and clutter_layout_manager_child_set_property() but it does not require a pointer to the ClutterContainer associated to the ClutterBinLayout

    +

    +

    @@ -424,27 +445,31 @@

    Property Details

    The "x-align" property

    -
      "x-align"                  ClutterBinAlignment   : Read / Write
    +
      "x-align"                  ClutterBinAlignment   : Read / Write

    The default horizontal alignment policy for actors managed by the ClutterBinLayout

    +

    +

    Default value: CLUTTER_BIN_ALIGNMENT_CENTER

    -

    Since 1.2

    +

    Since 1.2


    The "y-align" property

    -
      "y-align"                  ClutterBinAlignment   : Read / Write
    +
      "y-align"                  ClutterBinAlignment   : Read / Write

    The default vertical alignment policy for actors managed by the ClutterBinLayout

    +

    +

    Default value: CLUTTER_BIN_ALIGNMENT_CENTER

    -

    Since 1.2

    +

    Since 1.2

    + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ClutterTimeline.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ClutterTimeline.html @@ -8,7 +8,7 @@ - + @@ -62,14 +62,14 @@
    Top -  |  - Description -  |  - Object Hierarchy -  |  - Properties -  |  - Signals +  |  + Description +  |  + Object Hierarchy +  |  + Properties +  |  + Signals
    @@ -83,67 +83,120 @@

    Synopsis

    -
                        ClutterTimeline;
    +
    +                    ClutterTimeline;
                         ClutterTimelineClass;
    -ClutterTimeline *   clutter_timeline_new                (guint msecs);
    -ClutterTimeline *   clutter_timeline_clone              (ClutterTimeline *timeline);
    +ClutterTimeline *   clutter_timeline_new                (guint msecs);
    +ClutterTimeline *   clutter_timeline_clone              (ClutterTimeline *timeline);
     
    -void                clutter_timeline_set_duration       (ClutterTimeline *timeline,
    -                                                         guint msecs);
    -guint               clutter_timeline_get_duration       (ClutterTimeline *timeline);
    -void                clutter_timeline_set_loop           (ClutterTimeline *timeline,
    -                                                         gboolean loop);
    -gboolean            clutter_timeline_get_loop           (ClutterTimeline *timeline);
    -void                clutter_timeline_set_delay          (ClutterTimeline *timeline,
    -                                                         guint msecs);
    -guint               clutter_timeline_get_delay          (ClutterTimeline *timeline);
    +void                clutter_timeline_set_duration       (ClutterTimeline *timeline,
    +                                                         guint msecs);
    +guint               clutter_timeline_get_duration       (ClutterTimeline *timeline);
    +void                clutter_timeline_set_loop           (ClutterTimeline *timeline,
    +                                                         gboolean loop);
    +gboolean            clutter_timeline_get_loop           (ClutterTimeline *timeline);
    +void                clutter_timeline_set_delay          (ClutterTimeline *timeline,
    +                                                         guint msecs);
    +guint               clutter_timeline_get_delay          (ClutterTimeline *timeline);
     enum                ClutterTimelineDirection;
    -void                clutter_timeline_set_direction      (ClutterTimeline *timeline,
    -                                                         ClutterTimelineDirection direction);
    -ClutterTimelineDirection  clutter_timeline_get_direction
    -                                                        (ClutterTimeline *timeline);
    +void                clutter_timeline_set_direction      (ClutterTimeline *timeline,
    +                                                         ClutterTimelineDirection direction);
    +ClutterTimelineDirection  clutter_timeline_get_direction
    +                                                        (ClutterTimeline *timeline);
     
    -void                clutter_timeline_start              (ClutterTimeline *timeline);
    -void                clutter_timeline_pause              (ClutterTimeline *timeline);
    -void                clutter_timeline_stop               (ClutterTimeline *timeline);
    -void                clutter_timeline_rewind             (ClutterTimeline *timeline);
    -void                clutter_timeline_skip               (ClutterTimeline *timeline,
    -                                                         guint msecs);
    -void                clutter_timeline_advance            (ClutterTimeline *timeline,
    -                                                         guint msecs);
    -guint               clutter_timeline_get_elapsed_time   (ClutterTimeline *timeline);
    -guint               clutter_timeline_get_delta          (ClutterTimeline *timeline);
    -gdouble             clutter_timeline_get_progress       (ClutterTimeline *timeline);
    -gboolean            clutter_timeline_is_playing         (ClutterTimeline *timeline);
    +void                clutter_timeline_start              (ClutterTimeline *timeline);
    +void                clutter_timeline_pause              (ClutterTimeline *timeline);
    +void                clutter_timeline_stop               (ClutterTimeline *timeline);
    +void                clutter_timeline_rewind             (ClutterTimeline *timeline);
    +void                clutter_timeline_skip               (ClutterTimeline *timeline,
    +                                                         guint msecs);
    +void                clutter_timeline_advance            (ClutterTimeline *timeline,
    +                                                         guint msecs);
    +guint               clutter_timeline_get_elapsed_time   (ClutterTimeline *timeline);
    +guint               clutter_timeline_get_delta          (ClutterTimeline *timeline);
    +gdouble             clutter_timeline_get_progress       (ClutterTimeline *timeline);
    +gboolean            clutter_timeline_is_playing         (ClutterTimeline *timeline);
     
    -void                clutter_timeline_add_marker_at_time (ClutterTimeline *timeline,
    -                                                         const gchar *marker_name,
    -                                                         guint msecs);
    -gboolean            clutter_timeline_has_marker         (ClutterTimeline *timeline,
    -                                                         const gchar *marker_name);
    -gchar **            clutter_timeline_list_markers       (ClutterTimeline *timeline,
    -                                                         gint msecs,
    -                                                         gsize *n_markers);
    -void                clutter_timeline_remove_marker      (ClutterTimeline *timeline,
    -                                                         const gchar *marker_name);
    -void                clutter_timeline_advance_to_marker  (ClutterTimeline *timeline,
    -                                                         const gchar *marker_name);
    +void                clutter_timeline_add_marker_at_time (ClutterTimeline *timeline,
    +                                                         const gchar *marker_name,
    +                                                         guint msecs);
    +gboolean            clutter_timeline_has_marker         (ClutterTimeline *timeline,
    +                                                         const gchar *marker_name);
    +gchar **            clutter_timeline_list_markers       (ClutterTimeline *timeline,
    +                                                         gint msecs,
    +                                                         gsize *n_markers);
    +void                clutter_timeline_remove_marker      (ClutterTimeline *timeline,
    +                                                         const gchar *marker_name);
    +void                clutter_timeline_advance_to_marker  (ClutterTimeline *timeline,
    +                                                         const gchar *marker_name);
     

    Object Hierarchy

    -  GObject
    +  GObject
        +----ClutterTimeline
     

    Properties

    -  "delay"                    guint                 : Read / Write
    -  "direction"                ClutterTimelineDirection  : Read / Write
    -  "duration"                 guint                 : Read / Write
    -  "loop"                     gboolean              : Read / Write
    +  "delay"                    guint                 : Read / Write
    +  "direction"                ClutterTimelineDirection  : Read / Write
    +  "duration"                 guint                 : Read / Write
    +  "loop"                     gboolean              : Read / Write
     
    @@ -161,6 +214,8 @@

    ClutterTimeline is a base class for managing time based events such as animations.

    +

    +

    Details

    @@ -170,6 +225,8 @@

    The ClutterTimeline structure contains only private data and should be accessed using the provided API

    +

    +

    Since 0.2


    @@ -190,31 +247,33 @@

    The ClutterTimelineClass structure contains only private data

    +

    +

    - + - + - + - + - + @@ -225,9 +284,13 @@

    clutter_timeline_new ()

    -
    ClutterTimeline *   clutter_timeline_new                (guint msecs);
    +
    ClutterTimeline *   clutter_timeline_new                (guint msecs);

    Creates a new ClutterTimeline with a duration of msecs.

    +

    +

    started ()

    started ()

    handler for the "started" signal

    completed ()

    completed ()

    handler for the "completed" signal

    paused ()

    paused ()

    handler for the "paused" signal

    new_frame ()

    new_frame ()

    handler for the "new-frame" signal

    marker_reached ()

    marker_reached ()

    handler for the "marker-reached" signal
    @@ -239,7 +302,9 @@ @@ -250,12 +315,14 @@

    clutter_timeline_clone ()

    -
    ClutterTimeline *   clutter_timeline_clone              (ClutterTimeline *timeline);
    +
    ClutterTimeline *   clutter_timeline_clone              (ClutterTimeline *timeline);

    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().

    +

    +

    Returns :

    the newly created ClutterTimeline instance. Use - g_object_unref() when done using it + g_object_unref() when done using it
    @@ -277,11 +344,15 @@

    clutter_timeline_set_duration ()

    -
    void                clutter_timeline_set_duration       (ClutterTimeline *timeline,
    -                                                         guint msecs);
    +
    void                clutter_timeline_set_duration       (ClutterTimeline *timeline,
    +                                                         guint msecs);

    Sets the duration of the timeline, in milliseconds. The speed of the timeline depends on the ClutterTimeline:fps setting.

    +

    +

    @@ -302,10 +373,14 @@

    clutter_timeline_get_duration ()

    -
    guint               clutter_timeline_get_duration       (ClutterTimeline *timeline);
    +
    guint               clutter_timeline_get_duration       (ClutterTimeline *timeline);

    Retrieves the duration of a ClutterTimeline in milliseconds. See clutter_timeline_set_duration().

    +

    +

    @@ -327,10 +402,14 @@

    clutter_timeline_set_loop ()

    -
    void                clutter_timeline_set_loop           (ClutterTimeline *timeline,
    -                                                         gboolean loop);
    +
    void                clutter_timeline_set_loop           (ClutterTimeline *timeline,
    +                                                         gboolean loop);

    Sets whether timeline should loop.

    +

    +

    @@ -341,7 +420,7 @@ - @@ -350,9 +429,13 @@

    clutter_timeline_get_loop ()

    -
    gboolean            clutter_timeline_get_loop           (ClutterTimeline *timeline);
    +
    gboolean            clutter_timeline_get_loop           (ClutterTimeline *timeline);

    Gets whether timeline is looping

    +

    +

    loop :

    TRUE for enable looping + TRUE for enable looping
    @@ -363,7 +446,7 @@ - @@ -372,10 +455,14 @@

    clutter_timeline_set_delay ()

    -
    void                clutter_timeline_set_delay          (ClutterTimeline *timeline,
    -                                                         guint msecs);
    +
    void                clutter_timeline_set_delay          (ClutterTimeline *timeline,
    +                                                         guint msecs);

    Sets the delay, in milliseconds, before timeline should start.

    +

    +

    Returns :

    TRUE if the timeline is looping + TRUE if the timeline is looping
    @@ -396,9 +483,13 @@

    clutter_timeline_get_delay ()

    -
    guint               clutter_timeline_get_delay          (ClutterTimeline *timeline);
    +
    guint               clutter_timeline_get_delay          (ClutterTimeline *timeline);

    Retrieves the delay set using clutter_timeline_set_delay().

    +

    +

    @@ -427,16 +518,18 @@

    The direction of a ClutterTimeline

    +

    +

    - + - + @@ -447,11 +540,13 @@

    clutter_timeline_set_direction ()

    -
    void                clutter_timeline_set_direction      (ClutterTimeline *timeline,
    -                                                         ClutterTimelineDirection direction);
    +
    void                clutter_timeline_set_direction      (ClutterTimeline *timeline,
    +                                                         ClutterTimelineDirection direction);
    +

    +Sets the direction of timeline, either CLUTTER_TIMELINE_FORWARD or +CLUTTER_TIMELINE_BACKWARD.

    -Sets the direction of timeline, either CLUTTER_TIMELINE_FORWARD or -CLUTTER_TIMELINE_BACKWARD.

    +

    CLUTTER_TIMELINE_FORWARD

    CLUTTER_TIMELINE_FORWARD

    forward direction for a timeline

    CLUTTER_TIMELINE_BACKWARD

    CLUTTER_TIMELINE_BACKWARD

    backward direction for a timeline
    @@ -472,11 +567,13 @@

    clutter_timeline_get_direction ()

    -
    ClutterTimelineDirection  clutter_timeline_get_direction
    -                                                        (ClutterTimeline *timeline);
    +
    ClutterTimelineDirection  clutter_timeline_get_direction
    +                                                        (ClutterTimeline *timeline);

    Retrieves the direction of the timeline set with clutter_timeline_set_direction().

    +

    +

    @@ -498,9 +595,11 @@

    clutter_timeline_start ()

    -
    void                clutter_timeline_start              (ClutterTimeline *timeline);
    +
    void                clutter_timeline_start              (ClutterTimeline *timeline);

    Starts the ClutterTimeline playing.

    +

    +

    @@ -513,9 +612,11 @@

    clutter_timeline_pause ()

    -
    void                clutter_timeline_pause              (ClutterTimeline *timeline);
    +
    void                clutter_timeline_pause              (ClutterTimeline *timeline);

    Pauses the ClutterTimeline on current frame

    +

    +

    @@ -528,9 +629,11 @@

    clutter_timeline_stop ()

    -
    void                clutter_timeline_stop               (ClutterTimeline *timeline);
    +
    void                clutter_timeline_stop               (ClutterTimeline *timeline);

    Stops the ClutterTimeline and moves to frame 0

    +

    +

    @@ -543,11 +646,13 @@

    clutter_timeline_rewind ()

    -
    void                clutter_timeline_rewind             (ClutterTimeline *timeline);
    +
    void                clutter_timeline_rewind             (ClutterTimeline *timeline);

    Rewinds ClutterTimeline to the first frame if its direction is -CLUTTER_TIMELINE_FORWARD and the last frame if it is -CLUTTER_TIMELINE_BACKWARD.

    +CLUTTER_TIMELINE_FORWARD and the last frame if it is +CLUTTER_TIMELINE_BACKWARD.

    +

    +

    @@ -560,10 +665,14 @@

    clutter_timeline_skip ()

    -
    void                clutter_timeline_skip               (ClutterTimeline *timeline,
    -                                                         guint msecs);
    +
    void                clutter_timeline_skip               (ClutterTimeline *timeline,
    +                                                         guint msecs);

    Advance timeline by the requested time in milliseconds

    +

    +

    @@ -583,8 +692,10 @@

    clutter_timeline_advance ()

    -
    void                clutter_timeline_advance            (ClutterTimeline *timeline,
    -                                                         guint msecs);
    +
    void                clutter_timeline_advance            (ClutterTimeline *timeline,
    +                                                         guint msecs);

    Advance timeline to the requested point. The point is given as a time in milliseconds since the timeline started. @@ -598,6 +709,8 @@ clutter_timeline_advance() will be emit the skipped markers.

    +

    +

    @@ -617,9 +730,13 @@

    clutter_timeline_get_elapsed_time ()

    -
    guint               clutter_timeline_get_elapsed_time   (ClutterTimeline *timeline);
    +
    guint               clutter_timeline_get_elapsed_time   (ClutterTimeline *timeline);

    Request the current time position of the timeline.

    +

    +

    @@ -639,7 +756,9 @@

    clutter_timeline_get_delta ()

    -
    guint               clutter_timeline_get_delta          (ClutterTimeline *timeline);
    +
    guint               clutter_timeline_get_delta          (ClutterTimeline *timeline);

    Retrieves the amount of time elapsed since the last ClutterTimeline::new-frame signal. @@ -648,6 +767,8 @@ This function is only useful inside handlers for the ::new-frame signal, and its behaviour is undefined if the timeline is not playing.

    +

    +

    @@ -670,9 +791,13 @@

    clutter_timeline_get_progress ()

    -
    gdouble             clutter_timeline_get_progress       (ClutterTimeline *timeline);
    +
    gdouble             clutter_timeline_get_progress       (ClutterTimeline *timeline);

    The position of the timeline in a [0, 1] interval.

    +

    +

    @@ -694,9 +819,13 @@

    clutter_timeline_is_playing ()

    -
    gboolean            clutter_timeline_is_playing         (ClutterTimeline *timeline);
    +
    gboolean            clutter_timeline_is_playing         (ClutterTimeline *timeline);

    Queries state of a ClutterTimeline.

    +

    +

    @@ -707,7 +836,7 @@ - @@ -716,9 +845,13 @@

    clutter_timeline_add_marker_at_time ()

    -
    void                clutter_timeline_add_marker_at_time (ClutterTimeline *timeline,
    -                                                         const gchar *marker_name,
    -                                                         guint msecs);
    +
    void                clutter_timeline_add_marker_at_time (ClutterTimeline *timeline,
    +                                                         const gchar *marker_name,
    +                                                         guint msecs);

    Adds a named marker that will be hit when the timeline has been running for msecs milliseconds. Markers are unique string @@ -730,6 +863,8 @@ A marker can be removed with clutter_timeline_remove_marker(). The timeline can be advanced to a marker using clutter_timeline_advance_to_marker().

    +

    +

    Returns :

    TRUE if timeline is currently playing + TRUE if timeline is currently playing
    @@ -755,10 +890,16 @@

    clutter_timeline_has_marker ()

    -
    gboolean            clutter_timeline_has_marker         (ClutterTimeline *timeline,
    -                                                         const gchar *marker_name);
    +
    gboolean            clutter_timeline_has_marker         (ClutterTimeline *timeline,
    +                                                         const gchar *marker_name);

    Checks whether timeline has a marker set with the given name.

    +

    +

    @@ -774,7 +915,7 @@ - @@ -785,13 +926,21 @@

    clutter_timeline_list_markers ()

    -
    gchar **            clutter_timeline_list_markers       (ClutterTimeline *timeline,
    -                                                         gint msecs,
    -                                                         gsize *n_markers);
    +
    gchar **            clutter_timeline_list_markers       (ClutterTimeline *timeline,
    +                                                         gint msecs,
    +                                                         gsize *n_markers);

    Retrieves the list of markers at time msecs. If frame_num is a negative integer, all the markers attached to timeline will be returned.

    +

    +

    Returns :

    TRUE if the marker was found + TRUE if the marker was found
    @@ -812,7 +961,7 @@ - +

    Returns :

    array zero-terminated=1 length=n_markers. array zero-terminated=1 length=n_markers. array zero-terminated=1 length=n_markers. array zero-terminated=1 length=n_markers.
    @@ -821,10 +970,14 @@

    clutter_timeline_remove_marker ()

    -
    void                clutter_timeline_remove_marker      (ClutterTimeline *timeline,
    -                                                         const gchar *marker_name);
    +
    void                clutter_timeline_remove_marker      (ClutterTimeline *timeline,
    +                                                         const gchar *marker_name);

    Removes marker_name, if found, from timeline.

    +

    +

    @@ -845,8 +998,10 @@

    clutter_timeline_advance_to_marker ()

    -
    void                clutter_timeline_advance_to_marker  (ClutterTimeline *timeline,
    -                                                         const gchar *marker_name);
    +
    void                clutter_timeline_advance_to_marker  (ClutterTimeline *timeline,
    +                                                         const gchar *marker_name);

    Advances timeline to the time of the given marker_name.

    @@ -859,6 +1014,8 @@ is set, nor it will emit "marker-reached" for marker_name.

    +

    +

    @@ -881,39 +1038,53 @@

    Property Details

    The "delay" property

    -
      "delay"                    guint                 : Read / Write
    +
      "delay"                    guint                 : Read / Write

    A delay, in milliseconds, that should be observed by the timeline before actually starting.

    +

    +

    Default value: 0

    -

    Since 0.4

    +

    Since 0.4


    The "direction" property

    -
      "direction"                ClutterTimelineDirection  : Read / Write
    +
      "direction"                ClutterTimelineDirection  : Read / Write
    +

    +The direction of the timeline, either CLUTTER_TIMELINE_FORWARD or +CLUTTER_TIMELINE_BACKWARD.

    -The direction of the timeline, either CLUTTER_TIMELINE_FORWARD or -CLUTTER_TIMELINE_BACKWARD.

    +

    Default value: CLUTTER_TIMELINE_FORWARD

    -

    Since 0.6

    +

    Since 0.6


    The "duration" property

    -
      "duration"                 guint                 : Read / Write
    +
      "duration"                 guint                 : Read / Write

    Duration of the timeline in milliseconds, depending on the ClutterTimeline:fps value.

    +

    +

    Default value: 1000

    -

    Since 0.6

    +

    Since 0.6


    The "loop" property

    -
      "loop"                     gboolean              : Read / Write
    +
      "loop"                     gboolean              : Read / Write

    Whether the timeline should automatically rewind and restart.

    +

    +

    Default value: FALSE

    @@ -921,11 +1092,15 @@

    Signal Details

    The "completed" signal

    -
    void                user_function                      (ClutterTimeline *timeline,
    -                                                        gpointer         user_data)      : Run Last
    +
    void                user_function                      (ClutterTimeline *timeline,
    +                                                        gpointer         user_data)      : Run Last

    The ::completed signal is emitted when the timeline reaches the number of frames specified by the ClutterTimeline:num-frames property.

    +

    +

    @@ -944,10 +1119,16 @@

    The "marker-reached" signal

    -
    void                user_function                      (ClutterTimeline *timeline,
    -                                                        gchar           *marker_name,
    -                                                        gint             msecs,
    -                                                        gpointer         user_data)        : Run Last / No Recursion / Has Details / No Hooks
    +
    void                user_function                      (ClutterTimeline *timeline,
    +                                                        gchar           *marker_name,
    +                                                        gint             msecs,
    +                                                        gpointer         user_data)        : Run Last / No Recursion / Has Details / No Hooks

    The ::marker-reached signal is emitted each time a timeline reaches a marker set with @@ -974,6 +1155,8 @@ 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.

    +

    +

    @@ -998,18 +1181,24 @@
    -

    Since 0.8

    +

    Since 0.8


    The "new-frame" signal

    -
    void                user_function                      (ClutterTimeline *timeline,
    -                                                        gint             msecs,
    -                                                        gpointer         user_data)      : Run Last
    +
    void                user_function                      (ClutterTimeline *timeline,
    +                                                        gint             msecs,
    +                                                        gpointer         user_data)      : Run Last

    The ::new-frame signal is emitted for each timeline running timeline before a new frame is drawn to give animations a chance to update the scene.

    +

    +

    @@ -1033,10 +1222,14 @@

    The "paused" signal

    -
    void                user_function                      (ClutterTimeline *timeline,
    -                                                        gpointer         user_data)      : Run Last
    +
    void                user_function                      (ClutterTimeline *timeline,
    +                                                        gpointer         user_data)      : Run Last

    The ::paused signal is emitted when clutter_timeline_pause() is invoked.

    +

    +

    @@ -1055,13 +1248,17 @@

    The "started" signal

    -
    void                user_function                      (ClutterTimeline *timeline,
    -                                                        gpointer         user_data)      : Run Last
    +
    void                user_function                      (ClutterTimeline *timeline,
    +                                                        gpointer         user_data)      : Run Last

    The ::started signal is emitted when the timeline starts its run. This might be as soon as clutter_timeline_start() is invoked or after the delay set in the ClutterTimeline:delay property has expired.

    +

    +

    @@ -1081,6 +1278,6 @@ + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ch09.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ch09.html @@ -8,7 +8,7 @@ - + @@ -61,7 +61,7 @@

    -User interface definition

    +User interface definition
    ClutterScript — Loads a scene from UI definition data @@ -73,6 +73,6 @@
    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ClutterStage.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ClutterStage.html @@ -8,7 +8,7 @@ - + @@ -62,16 +62,16 @@ Top -  |  - Description -  |  - Object Hierarchy -  |  - Implemented Interfaces -  |  - Properties -  |  - Signals +  |  + Description +  |  + Object Hierarchy +  |  + Implemented Interfaces +  |  + Properties +  |  + Signals
    @@ -85,85 +85,140 @@

    Synopsis

    -
                        ClutterStage;
    +
    +                    ClutterStage;
                         ClutterStageClass;
    -#define             CLUTTER_STAGE_WIDTH                 ()
    -#define             CLUTTER_STAGE_HEIGHT                ()
    -ClutterActor *      clutter_stage_get_default           (void);
    -ClutterActor *      clutter_stage_new                   (void);
    -gboolean            clutter_stage_is_default            (ClutterStage *stage);
    +#define             CLUTTER_STAGE_WIDTH                 ()
    +#define             CLUTTER_STAGE_HEIGHT                ()
    +ClutterActor *      clutter_stage_get_default           (void);
    +ClutterActor *      clutter_stage_new                   (void);
    +gboolean            clutter_stage_is_default            (ClutterStage *stage);
     
    -void                clutter_stage_set_color             (ClutterStage *stage,
    -                                                         const ClutterColor *color);
    -void                clutter_stage_get_color             (ClutterStage *stage,
    -                                                         ClutterColor *color);
    -void                clutter_stage_set_fullscreen        (ClutterStage *stage,
    -                                                         gboolean fullscreen);
    -gboolean            clutter_stage_get_fullscreen        (ClutterStage *stage);
    -void                clutter_stage_show_cursor           (ClutterStage *stage);
    -void                clutter_stage_hide_cursor           (ClutterStage *stage);
    +void                clutter_stage_set_color             (ClutterStage *stage,
    +                                                         const ClutterColor *color);
    +void                clutter_stage_get_color             (ClutterStage *stage,
    +                                                         ClutterColor *color);
    +void                clutter_stage_set_fullscreen        (ClutterStage *stage,
    +                                                         gboolean fullscreen);
    +gboolean            clutter_stage_get_fullscreen        (ClutterStage *stage);
    +void                clutter_stage_show_cursor           (ClutterStage *stage);
    +void                clutter_stage_hide_cursor           (ClutterStage *stage);
     enum                ClutterPickMode;
    -ClutterActor *      clutter_stage_get_actor_at_pos      (ClutterStage *stage,
    -                                                         ClutterPickMode pick_mode,
    -                                                         gint x,
    -                                                         gint y);
    -void                clutter_stage_ensure_current        (ClutterStage *stage);
    -void                clutter_stage_ensure_viewport       (ClutterStage *stage);
    -void                clutter_stage_ensure_redraw         (ClutterStage *stage);
    -void                clutter_stage_queue_redraw          (ClutterStage *stage);
    -gboolean            clutter_stage_event                 (ClutterStage *stage,
    -                                                         ClutterEvent *event);
    -void                clutter_stage_set_key_focus         (ClutterStage *stage,
    -                                                         ClutterActor *actor);
    -ClutterActor *      clutter_stage_get_key_focus         (ClutterStage *stage);
    -guchar *            clutter_stage_read_pixels           (ClutterStage *stage,
    -                                                         gint x,
    -                                                         gint y,
    -                                                         gint width,
    -                                                         gint height);
    -void                clutter_stage_set_throttle_motion_events
    -                                                        (ClutterStage *stage,
    -                                                         gboolean throttle);
    -gboolean            clutter_stage_get_throttle_motion_events
    -                                                        (ClutterStage *stage);
    -void                clutter_stage_set_use_alpha         (ClutterStage *stage,
    -                                                         gboolean use_alpha);
    -gboolean            clutter_stage_get_use_alpha         (ClutterStage *stage);
    -void                clutter_stage_set_minimum_size      (ClutterStage *stage,
    -                                                         guint width,
    -                                                         guint height);
    -void                clutter_stage_get_minimum_size      (ClutterStage *stage,
    -                                                         guint *width,
    -                                                         guint *height);
    +ClutterActor *      clutter_stage_get_actor_at_pos      (ClutterStage *stage,
    +                                                         ClutterPickMode pick_mode,
    +                                                         gint x,
    +                                                         gint y);
    +void                clutter_stage_ensure_current        (ClutterStage *stage);
    +void                clutter_stage_ensure_viewport       (ClutterStage *stage);
    +void                clutter_stage_ensure_redraw         (ClutterStage *stage);
    +void                clutter_stage_queue_redraw          (ClutterStage *stage);
    +gboolean            clutter_stage_event                 (ClutterStage *stage,
    +                                                         ClutterEvent *event);
    +void                clutter_stage_set_key_focus         (ClutterStage *stage,
    +                                                         ClutterActor *actor);
    +ClutterActor *      clutter_stage_get_key_focus         (ClutterStage *stage);
    +guchar *            clutter_stage_read_pixels           (ClutterStage *stage,
    +                                                         gint x,
    +                                                         gint y,
    +                                                         gint width,
    +                                                         gint height);
    +void                clutter_stage_set_throttle_motion_events
    +                                                        (ClutterStage *stage,
    +                                                         gboolean throttle);
    +gboolean            clutter_stage_get_throttle_motion_events
    +                                                        (ClutterStage *stage);
    +void                clutter_stage_set_use_alpha         (ClutterStage *stage,
    +                                                         gboolean use_alpha);
    +gboolean            clutter_stage_get_use_alpha         (ClutterStage *stage);
    +void                clutter_stage_set_minimum_size      (ClutterStage *stage,
    +                                                         guint width,
    +                                                         guint height);
    +void                clutter_stage_get_minimum_size      (ClutterStage *stage,
    +                                                         guint *width,
    +                                                         guint *height);
     
                         ClutterPerspective;
    -void                clutter_stage_set_perspective       (ClutterStage *stage,
    -                                                         ClutterPerspective *perspective);
    -void                clutter_stage_get_perspective       (ClutterStage *stage,
    -                                                         ClutterPerspective *perspective);
    +void                clutter_stage_set_perspective       (ClutterStage *stage,
    +                                                         ClutterPerspective *perspective);
    +void                clutter_stage_get_perspective       (ClutterStage *stage,
    +                                                         ClutterPerspective *perspective);
     
    -void                clutter_stage_set_title             (ClutterStage *stage,
    -                                                         const gchar *title);
    -const gchar *       clutter_stage_get_title             (ClutterStage *stage);
    -void                clutter_stage_set_user_resizable    (ClutterStage *stage,
    -                                                         gboolean resizable);
    -gboolean            clutter_stage_get_user_resizable    (ClutterStage *stage);
    +void                clutter_stage_set_title             (ClutterStage *stage,
    +                                                         const gchar *title);
    +const gchar *       clutter_stage_get_title             (ClutterStage *stage);
    +void                clutter_stage_set_user_resizable    (ClutterStage *stage,
    +                                                         gboolean resizable);
    +gboolean            clutter_stage_get_user_resizable    (ClutterStage *stage);
     
                         ClutterFog;
    -void                clutter_stage_set_use_fog           (ClutterStage *stage,
    -                                                         gboolean fog);
    -gboolean            clutter_stage_get_use_fog           (ClutterStage *stage);
    -void                clutter_stage_set_fog               (ClutterStage *stage,
    -                                                         ClutterFog *fog);
    -void                clutter_stage_get_fog               (ClutterStage *stage,
    -                                                         ClutterFog *fog);
    +void                clutter_stage_set_use_fog           (ClutterStage *stage,
    +                                                         gboolean fog);
    +gboolean            clutter_stage_get_use_fog           (ClutterStage *stage);
    +void                clutter_stage_set_fog               (ClutterStage *stage,
    +                                                         ClutterFog *fog);
    +void                clutter_stage_get_fog               (ClutterStage *stage,
    +                                                         ClutterFog *fog);
     

    Object Hierarchy

    -  GObject
    -   +----GInitiallyUnowned
    +  GObject
    +   +----GInitiallyUnowned
              +----ClutterActor
                    +----ClutterGroup
                          +----ClutterStage
    @@ -178,17 +233,31 @@
     

    Properties

    -  "color"                    ClutterColor*         : Read / Write
    -  "cursor-visible"           gboolean              : Read / Write
    -  "fog"                      ClutterFog*           : Read / Write
    -  "fullscreen-set"           gboolean              : Read
    -  "key-focus"                ClutterActor*         : Read / Write
    -  "offscreen"                gboolean              : Read / Write
    -  "perspective"              ClutterPerspective*   : Read / Write
    -  "title"                    gchar*                : Read / Write
    -  "use-alpha"                gboolean              : Read / Write
    -  "use-fog"                  gboolean              : Read / Write
    -  "user-resizable"           gboolean              : Read / Write
    +  "color"                    ClutterColor*         : Read / Write
    +  "cursor-visible"           gboolean              : Read / Write
    +  "fog"                      ClutterFog*           : Read / Write
    +  "fullscreen-set"           gboolean              : Read
    +  "key-focus"                ClutterActor*         : Read / Write
    +  "offscreen"                gboolean              : Read / Write
    +  "perspective"              ClutterPerspective*   : Read / Write
    +  "title"                    gchar*                : Read / Write
    +  "use-alpha"                gboolean              : Read / Write
    +  "use-fog"                  gboolean              : Read / Write
    +  "user-resizable"           gboolean              : Read / Write
     
    @@ -216,7 +285,7 @@

    Backends might provide support for multiple stages. The support for this feature can be checked at run-time using the clutter_feature_available() -function and the CLUTTER_FEATURE_STAGE_MULTIPLE flag. If the backend used +function and the CLUTTER_FEATURE_STAGE_MULTIPLE flag. If the backend used supports multiple stages, new ClutterStage instances can be created using clutter_stage_new(). These stages must be managed by the developer using clutter_actor_destroy(), which will take care of destroying all the @@ -227,6 +296,8 @@ implementation of the windowing system. It is possible to subclass ClutterStage, as long as every overridden virtual function chains up to the parent class corresponding function.

    +

    +

    Details

    @@ -236,6 +307,8 @@

    The ClutterStage structure contains only private data and should be accessed using the provided API

    +

    +

    Since 0.1


    @@ -254,31 +327,33 @@

    The ClutterStageClass structure contains only private data

    +

    +

    - + - + - + - + - + @@ -288,7 +363,7 @@
    -

    CLUTTER_STAGE_WIDTH()

    +

    CLUTTER_STAGE_WIDTH()

    #define CLUTTER_STAGE_WIDTH()           (clutter_actor_get_width (clutter_stage_get_default ()))
     
    @@ -297,11 +372,13 @@

    Macro that evaluates to the width of the default stage

    +

    +

    Since 0.2


    -

    CLUTTER_STAGE_HEIGHT()

    +

    CLUTTER_STAGE_HEIGHT()

    #define CLUTTER_STAGE_HEIGHT()          (clutter_actor_get_height (clutter_stage_get_default ()))
     
    @@ -310,12 +387,14 @@

    Macro that evaluates to the height of the default stage

    +

    +

    Since 0.2


    clutter_stage_get_default ()

    -
    ClutterActor *      clutter_stage_get_default           (void);
    +
    ClutterActor *      clutter_stage_get_default           (void);

    Returns the main stage. The default ClutterStage is a singleton, so the stage will be created the first time this function is @@ -324,18 +403,20 @@

    Clutter guarantess the existence of the default stage.

    +

    +

    fullscreen ()

    fullscreen ()

    handler for the "fullscreen" signal

    unfullscreen ()

    unfullscreen ()

    handler for the "unfullscreen" signal

    activate ()

    activate ()

    handler for the "activate" signal

    deactivate ()

    deactivate ()

    handler for the "deactive" signal

    delete_event ()

    delete_event ()

    handler for the "delete-event" signal
    - +

    Returns :

    transfer none. transfer none. transfer none. transfer none.

    clutter_stage_new ()

    -
    ClutterActor *      clutter_stage_new                   (void);
    +
    ClutterActor *      clutter_stage_new                   (void);

    Creates a new, non-default stage. A non-default stage is a new top-level actor which can be used as another container. It works @@ -346,13 +427,15 @@

    The ability to support multiple stages depends on the current backend. Use clutter_feature_available() and -CLUTTER_FEATURE_STAGE_MULTIPLE to check at runtime whether a +CLUTTER_FEATURE_STAGE_MULTIPLE to check at runtime whether a backend supports multiple stages.

    +

    +

    -

    Returns :

    a new stage, or NULL if the default backend does + a new stage, or NULL if the default backend does not support multiple stages. Use clutter_actor_destroy() to programmatically close the returned stage. @@ -364,10 +447,14 @@

    clutter_stage_is_default ()

    -
    gboolean            clutter_stage_is_default            (ClutterStage *stage);
    +
    gboolean            clutter_stage_is_default            (ClutterStage *stage);

    Checks if stage is the default stage, or an instance created using clutter_stage_new() but internally using the same implementation.

    +

    +

    @@ -378,7 +465,7 @@ - @@ -389,10 +476,12 @@

    clutter_stage_set_color ()

    -
    void                clutter_stage_set_color             (ClutterStage *stage,
    -                                                         const ClutterColor *color);
    +
    void                clutter_stage_set_color             (ClutterStage *stage,
    +                                                         const ClutterColor *color);

    Sets the stage color.

    +

    +

    Returns :

    TRUE if the passed stage is the default one + TRUE if the passed stage is the default one
    @@ -412,10 +501,12 @@

    clutter_stage_get_color ()

    -
    void                clutter_stage_get_color             (ClutterStage *stage,
    -                                                         ClutterColor *color);
    +
    void                clutter_stage_get_color             (ClutterStage *stage,
    +                                                         ClutterColor *color);

    Retrieves the stage color.

    +

    +

    @@ -435,8 +526,10 @@

    clutter_stage_set_fullscreen ()

    -
    void                clutter_stage_set_fullscreen        (ClutterStage *stage,
    -                                                         gboolean fullscreen);
    +
    void                clutter_stage_set_fullscreen        (ClutterStage *stage,
    +                                                         gboolean fullscreen);

    Asks to place the stage window in the fullscreen or unfullscreen states. @@ -452,6 +545,8 @@ should either use the "fullscreen" and "unfullscreen" signals, or use the notify signal for the "fullscreen-set" property

    +

    +

    @@ -462,7 +557,7 @@ - @@ -472,9 +567,13 @@

    clutter_stage_get_fullscreen ()

    -
    gboolean            clutter_stage_get_fullscreen        (ClutterStage *stage);
    +
    gboolean            clutter_stage_get_fullscreen        (ClutterStage *stage);

    Retrieves whether the stage is full screen or not

    +

    +

    fullscreen :

    TRUE to to set the stage fullscreen + TRUE to to set the stage fullscreen
    @@ -485,7 +584,7 @@ - @@ -496,9 +595,11 @@

    clutter_stage_show_cursor ()

    -
    void                clutter_stage_show_cursor           (ClutterStage *stage);
    +
    void                clutter_stage_show_cursor           (ClutterStage *stage);

    Shows the cursor on the stage window

    +

    +

    Returns :

    TRUE if the stage is full screen + TRUE if the stage is full screen
    @@ -511,9 +612,11 @@

    clutter_stage_hide_cursor ()

    -
    void                clutter_stage_hide_cursor           (ClutterStage *stage);
    +
    void                clutter_stage_hide_cursor           (ClutterStage *stage);

    Makes the cursor invisible on the stage window

    +

    +

    @@ -535,21 +638,23 @@

    Controls the paint cycle of the scene graph when in pick mode

    +

    +

    - + - + - + @@ -560,10 +665,14 @@

    clutter_stage_get_actor_at_pos ()

    -
    ClutterActor *      clutter_stage_get_actor_at_pos      (ClutterStage *stage,
    -                                                         ClutterPickMode pick_mode,
    -                                                         gint x,
    -                                                         gint y);
    +
    ClutterActor *      clutter_stage_get_actor_at_pos      (ClutterStage *stage,
    +                                                         ClutterPickMode pick_mode,
    +                                                         gint x,
    +                                                         gint y);

    Checks the scene at the coordinates x and y and returns a pointer to the ClutterActor at those coordinates. @@ -571,6 +680,8 @@

    By using pick_mode it is possible to control which actors will be painted and thus available.

    +

    +

    CLUTTER_PICK_NONE

    CLUTTER_PICK_NONE

    Do not paint any actor

    CLUTTER_PICK_REACTIVE

    CLUTTER_PICK_REACTIVE

    Paint only the reactive actors

    CLUTTER_PICK_ALL

    CLUTTER_PICK_ALL

    Paint all actors
    @@ -596,7 +707,7 @@ - +

    Returns :

    transfer none. transfer none. transfer none. transfer none.
    @@ -604,11 +715,13 @@

    clutter_stage_ensure_current ()

    -
    void                clutter_stage_ensure_current        (ClutterStage *stage);
    +
    void                clutter_stage_ensure_current        (ClutterStage *stage);

    This function essentially makes sure the right GL context is current for the passed stage. It is not intended to be used by applications.

    +

    +

    @@ -622,7 +735,7 @@

    clutter_stage_ensure_viewport ()

    -
    void                clutter_stage_ensure_viewport       (ClutterStage *stage);
    +
    void                clutter_stage_ensure_viewport       (ClutterStage *stage);

    Ensures that the GL viewport is updated with the current stage window size. @@ -634,6 +747,8 @@ This function should not be called by applications; it is used when embedding a ClutterStage into a toolkit with another windowing system, like GTK+.

    +

    +

    @@ -647,7 +762,7 @@

    clutter_stage_ensure_redraw ()

    -
    void                clutter_stage_ensure_redraw         (ClutterStage *stage);
    +
    void                clutter_stage_ensure_redraw         (ClutterStage *stage);

    Ensures that stage is redrawn

    @@ -655,6 +770,8 @@ This function should not be called by applications: it is used when embedding a ClutterStage into a toolkit with another windowing system, like GTK+.

    +

    +

    @@ -668,7 +785,7 @@

    clutter_stage_queue_redraw ()

    -
    void                clutter_stage_queue_redraw          (ClutterStage *stage);
    +
    void                clutter_stage_queue_redraw          (ClutterStage *stage);

    Queues a redraw for the passed stage.

    @@ -684,6 +801,8 @@

    Note

    This function is just a wrapper for clutter_actor_queue_redraw() and should probably go away.
    +

    +

    @@ -697,14 +816,18 @@

    clutter_stage_event ()

    -
    gboolean            clutter_stage_event                 (ClutterStage *stage,
    -                                                         ClutterEvent *event);
    +
    gboolean            clutter_stage_event                 (ClutterStage *stage,
    +                                                         ClutterEvent *event);

    This function is used to emit an event on the main stage.

    You should rarely need to use this function, except for synthetised events.

    +

    +

    @@ -731,12 +854,14 @@

    clutter_stage_set_key_focus ()

    -
    void                clutter_stage_set_key_focus         (ClutterStage *stage,
    -                                                         ClutterActor *actor);
    +
    void                clutter_stage_set_key_focus         (ClutterStage *stage,
    +                                                         ClutterActor *actor);

    Sets the key focus on actor. An actor with key focus will receive -all the key events. If actor is NULL, the stage will receive +all the key events. If actor is NULL, the stage will receive focus.

    +

    +

    @@ -747,7 +872,7 @@ - +

    actor :

    the actor to set key focus to, or NULL. allow-none. the actor to set key focus to, or NULL. allow-none.
    @@ -756,9 +881,11 @@

    clutter_stage_get_key_focus ()

    -
    ClutterActor *      clutter_stage_get_key_focus         (ClutterStage *stage);
    +
    ClutterActor *      clutter_stage_get_key_focus         (ClutterStage *stage);

    Retrieves the actor that is currently under key focus.

    +

    +

    @@ -769,7 +896,7 @@ - +

    Returns :

    the actor with key focus, or the stage. transfer none. the actor with key focus, or the stage. transfer none.
    @@ -778,11 +905,21 @@

    clutter_stage_read_pixels ()

    -
    guchar *            clutter_stage_read_pixels           (ClutterStage *stage,
    -                                                         gint x,
    -                                                         gint y,
    -                                                         gint width,
    -                                                         gint height);
    +
    guchar *            clutter_stage_read_pixels           (ClutterStage *stage,
    +                                                         gint x,
    +                                                         gint y,
    +                                                         gint width,
    +                                                         gint height);

    Makes a screenshot of the stage in RGBA 8bit data, returns a linear buffer with width * 4 as rowstride. @@ -790,6 +927,8 @@

    The alpha data contained in the returned buffer is driver-dependent, and not guaranteed to hold any sensible value.

    +

    +

    @@ -823,7 +962,9 @@ @@ -833,9 +974,11 @@

    clutter_stage_set_throttle_motion_events ()

    -
    void                clutter_stage_set_throttle_motion_events
    -                                                        (ClutterStage *stage,
    -                                                         gboolean throttle);
    +
    void                clutter_stage_set_throttle_motion_events
    +                                                        (ClutterStage *stage,
    +                                                         gboolean throttle);

    Sets whether motion events received between redraws should be throttled or not. If motion events are throttled, those @@ -846,6 +989,8 @@

    This function should only be used if you want to have all the motion events delivered to your application code.

    +

    +

    Returns :

    a pointer to newly allocated memory with the buffer - or NULL if the read failed. Use g_free() on the returned data + or NULL if the read failed. Use g_free() on the returned data to release the resources it has allocated.
    @@ -856,7 +1001,7 @@ - @@ -866,10 +1011,14 @@

    clutter_stage_get_throttle_motion_events ()

    -
    gboolean            clutter_stage_get_throttle_motion_events
    -                                                        (ClutterStage *stage);
    +
    gboolean            clutter_stage_get_throttle_motion_events
    +                                                        (ClutterStage *stage);

    Retrieves the value set with clutter_stage_set_throttle_motion_events()

    +

    +

    throttle :

    TRUE to throttle motion events + TRUE to throttle motion events
    @@ -880,8 +1029,8 @@ - @@ -892,11 +1041,15 @@

    clutter_stage_set_use_alpha ()

    -
    void                clutter_stage_set_use_alpha         (ClutterStage *stage,
    -                                                         gboolean use_alpha);
    +
    void                clutter_stage_set_use_alpha         (ClutterStage *stage,
    +                                                         gboolean use_alpha);

    Sets whether the stage should honour the "opacity" and the alpha channel of the "color"

    +

    +

    Returns :

    TRUE if the motion events are being throttled, - and FALSE otherwise + TRUE if the motion events are being throttled, + and FALSE otherwise
    @@ -918,9 +1071,13 @@

    clutter_stage_get_use_alpha ()

    -
    gboolean            clutter_stage_get_use_alpha         (ClutterStage *stage);
    +
    gboolean            clutter_stage_get_use_alpha         (ClutterStage *stage);

    Retrieves the value set using clutter_stage_set_use_alpha()

    +

    +

    @@ -931,7 +1088,7 @@ - @@ -943,9 +1100,13 @@

    clutter_stage_set_minimum_size ()

    -
    void                clutter_stage_set_minimum_size      (ClutterStage *stage,
    -                                                         guint width,
    -                                                         guint height);
    +
    void                clutter_stage_set_minimum_size      (ClutterStage *stage,
    +                                                         guint width,
    +                                                         guint height);

    Sets the minimum size for a stage window, if the default backend uses ClutterStage inside a window @@ -960,6 +1121,8 @@

    This function has no effect if stage is fullscreen

    +

    +

    Returns :

    TRUE if the stage should honour the opacity and the + TRUE if the stage should honour the opacity and the alpha channel of the stage color
    @@ -985,9 +1148,13 @@

    clutter_stage_get_minimum_size ()

    -
    void                clutter_stage_get_minimum_size      (ClutterStage *stage,
    -                                                         guint *width,
    -                                                         guint *height);
    +
    void                clutter_stage_get_minimum_size      (ClutterStage *stage,
    +                                                         guint *width,
    +                                                         guint *height);

    Retrieves the minimum size for a stage window as set using clutter_stage_set_minimum_size(). @@ -996,6 +1163,8 @@ The returned size may not correspond to the actual minimum size and it is specific to the ClutterStage implementation inside the Clutter backend

    +

    +

    @@ -1006,11 +1175,11 @@ - + - +

    width :

    out. out. out. out.

    height :

    out. out. out. out.
    @@ -1029,28 +1198,38 @@

    Stage perspective definition. ClutterPerspective is only used by the fixed point version of clutter_stage_set_perspective().

    +

    +

    - + - + - + - + @@ -1062,10 +1241,12 @@

    clutter_stage_set_perspective ()

    -
    void                clutter_stage_set_perspective       (ClutterStage *stage,
    -                                                         ClutterPerspective *perspective);
    +
    void                clutter_stage_set_perspective       (ClutterStage *stage,
    +                                                         ClutterPerspective *perspective);

    Sets the stage perspective.

    +

    +

    gfloat fovy;

    gfloat fovy;

    the field of view angle, in degrees, in the y direction

    gfloat aspect;

    gfloat aspect;

    the aspect ratio that determines the field of view in the x direction. The aspect ratio is the ratio of x (width) to y (height)

    gfloat z_near;

    gfloat z_near;

    the distance from the viewer to the near clipping plane (always positive)

    gfloat z_far;

    gfloat z_far;

    the distance from the viewer to the far clipping plane (always positive)
    @@ -1085,10 +1266,12 @@

    clutter_stage_get_perspective ()

    -
    void                clutter_stage_get_perspective       (ClutterStage *stage,
    -                                                         ClutterPerspective *perspective);
    +
    void                clutter_stage_get_perspective       (ClutterStage *stage,
    +                                                         ClutterPerspective *perspective);

    Retrieves the stage perspective.

    +

    +

    @@ -1108,10 +1291,14 @@

    clutter_stage_set_title ()

    -
    void                clutter_stage_set_title             (ClutterStage *stage,
    -                                                         const gchar *title);
    +
    void                clutter_stage_set_title             (ClutterStage *stage,
    +                                                         const gchar *title);

    Sets the stage title.

    +

    +

    @@ -1132,9 +1319,13 @@

    clutter_stage_get_title ()

    -
    const gchar *       clutter_stage_get_title             (ClutterStage *stage);
    +
    const gchar *       clutter_stage_get_title             (ClutterStage *stage);

    Gets the stage title.

    +

    +

    @@ -1158,11 +1349,15 @@

    clutter_stage_set_user_resizable ()

    -
    void                clutter_stage_set_user_resizable    (ClutterStage *stage,
    -                                                         gboolean resizable);
    +
    void                clutter_stage_set_user_resizable    (ClutterStage *stage,
    +                                                         gboolean resizable);

    Sets if the stage is resizable by user interaction (e.g. via window manager controls)

    +

    +

    @@ -1183,9 +1378,13 @@

    clutter_stage_get_user_resizable ()

    -
    gboolean            clutter_stage_get_user_resizable    (ClutterStage *stage);
    +
    gboolean            clutter_stage_get_user_resizable    (ClutterStage *stage);

    Retrieves the value set with clutter_stage_set_user_resizable().

    +

    +

    @@ -1196,7 +1395,7 @@ - @@ -1214,17 +1413,23 @@

    Fog settings used to create the depth cueing effect.

    +

    +

    Returns :

    TRUE if the stage is resizable by the user. + TRUE if the stage is resizable by the user.
    - + - + @@ -1236,8 +1441,10 @@

    clutter_stage_set_use_fog ()

    -
    void                clutter_stage_set_use_fog           (ClutterStage *stage,
    -                                                         gboolean fog);
    +
    void                clutter_stage_set_use_fog           (ClutterStage *stage,
    +                                                         gboolean fog);

    Sets whether the depth cueing effect on the stage should be enabled or not. @@ -1249,6 +1456,8 @@

    The parameters of the GL fog used can be changed using the clutter_stage_set_fog() function.

    +

    +

    gfloat z_near;

    gfloat z_near;

    starting distance from the viewer to the near clipping plane (always positive)

    gfloat z_far;

    gfloat z_far;

    final distance from the viewer to the far clipping plane (always positive)
    @@ -1259,7 +1468,7 @@ - @@ -1269,9 +1478,13 @@

    clutter_stage_get_use_fog ()

    -
    gboolean            clutter_stage_get_use_fog           (ClutterStage *stage);
    +
    gboolean            clutter_stage_get_use_fog           (ClutterStage *stage);

    Gets whether the depth cueing effect is enabled on stage.

    +

    +

    fog :

    TRUE for enabling the depth cueing effect + TRUE for enabling the depth cueing effect
    @@ -1282,7 +1495,7 @@ - @@ -1293,14 +1506,16 @@

    clutter_stage_set_fog ()

    -
    void                clutter_stage_set_fog               (ClutterStage *stage,
    -                                                         ClutterFog *fog);
    +
    void                clutter_stage_set_fog               (ClutterStage *stage,
    +                                                         ClutterFog *fog);

    Sets the fog (also known as "depth cueing") settings for the stage.

    A ClutterStage will only use a linear fog progression, which -depends solely on the distance from the viewer. The cogl_set_fog() +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 "use-fog" property and connecting @@ -1316,7 +1531,9 @@

    -The paint signal handler will call cogl_set_fog() with the +The paint signal handler will call cogl_set_fog() with the desired settings:

    @@ -1356,6 +1573,8 @@

    We can look to improve this in the future when we can depend on fragment shaders.

    +

    +

    Returns :

    TRUE if the the depth cueing effect is enabled + TRUE if the the depth cueing effect is enabled
    @@ -1376,10 +1595,12 @@

    clutter_stage_get_fog ()

    -
    void                clutter_stage_get_fog               (ClutterStage *stage,
    -                                                         ClutterFog *fog);
    +
    void                clutter_stage_get_fog               (ClutterStage *stage,
    +                                                         ClutterFog *fog);

    Retrieves the current depth cueing settings from the stage.

    +

    +

    @@ -1402,50 +1623,64 @@

    Property Details

    The "color" property

    -
      "color"                    ClutterColor*         : Read / Write
    +
      "color"                    ClutterColor*         : Read / Write

    The color of the main stage.

    +

    +


    The "cursor-visible" property

    -
      "cursor-visible"           gboolean              : Read / Write
    +
      "cursor-visible"           gboolean              : Read / Write

    Whether the mouse pointer should be visible

    +

    +

    Default value: TRUE


    The "fog" property

    -
      "fog"                      ClutterFog*           : Read / Write
    +
      "fog"                      ClutterFog*           : Read / Write

    The settings for the GL "fog", used only if "use-fog" -is set to TRUE

    -

    Since 1.0

    +is set to TRUE

    +

    +

    +

    Since 1.0


    The "fullscreen-set" property

    -
      "fullscreen-set"           gboolean              : Read
    +
      "fullscreen-set"           gboolean              : Read

    Whether the main stage is fullscreen.

    Default value: FALSE


    The "key-focus" property

    -
      "key-focus"                ClutterActor*         : Read / Write
    +
      "key-focus"                ClutterActor*         : Read / Write

    The ClutterActor that will receive key events from the underlying windowing system.

    -If NULL, the ClutterStage will receive the events.

    -

    Since 1.2

    +If NULL, the ClutterStage will receive the events.

    +

    +

    +

    Since 1.2


    The "offscreen" property

    -
      "offscreen"                gboolean              : Read / Write
    +
      "offscreen"                gboolean              : Read / Write

    Whether the stage should be rendered in an offscreen buffer.

    @@ -1457,68 +1692,92 @@ stage to an offscreen buffer. This property might not work and it might be deprecated at any later date.

    +

    +

    Default value: FALSE


    The "perspective" property

    -
      "perspective"              ClutterPerspective*   : Read / Write
    +
      "perspective"              ClutterPerspective*   : Read / Write

    The parameters used for the perspective projection from 3D coordinates to 2D

    -

    Since 0.8.2

    +

    +

    +

    Since 0.8.2


    The "title" property

    -
      "title"                    gchar*                : Read / Write
    +
      "title"                    gchar*                : Read / Write

    The stage's title - usually displayed in stage windows title decorations.

    +

    +

    Default value: NULL

    -

    Since 0.4

    +

    Since 0.4


    The "use-alpha" property

    -
      "use-alpha"                gboolean              : Read / Write
    +
      "use-alpha"                gboolean              : Read / Write

    Whether the ClutterStage should honour the alpha component of the "color" property when painting. If Clutter is run under a compositing manager this will result in the stage being blended with the underlying window(s)

    +

    +

    Default value: FALSE

    -

    Since 1.2

    +

    Since 1.2


    The "use-fog" property

    -
      "use-fog"                  gboolean              : Read / Write
    +
      "use-fog"                  gboolean              : Read / Write

    Whether the stage should use a linear GL "fog" in creating the depth-cueing effect, to enhance the perception of depth by fading actors farther from the viewpoint.

    +

    +

    Default value: FALSE

    -

    Since 0.6

    +

    Since 0.6


    The "user-resizable" property

    -
      "user-resizable"           gboolean              : Read / Write
    +
      "user-resizable"           gboolean              : Read / Write

    Whether the stage is resizable via user interaction.

    +

    +

    Default value: FALSE

    -

    Since 0.4

    +

    Since 0.4

    Signal Details

    The "activate" signal

    -
    void                user_function                      (ClutterStage *stage,
    -                                                        gpointer      user_data)      : Run Last
    +
    void                user_function                      (ClutterStage *stage,
    +                                                        gpointer      user_data)      : Run Last

    The ::activate signal is emitted when the stage receives key focus from the underlying window system.

    +

    +

    @@ -1533,16 +1792,20 @@
    -

    Since 0.6

    +

    Since 0.6


    The "deactivate" signal

    -
    void                user_function                      (ClutterStage *stage,
    -                                                        gpointer      user_data)      : Run Last
    +
    void                user_function                      (ClutterStage *stage,
    +                                                        gpointer      user_data)      : Run Last

    The ::activate signal is emitted when the stage loses key focus from the underlying window system.

    +

    +

    @@ -1557,14 +1820,18 @@
    -

    Since 0.6

    +

    Since 0.6


    The "delete-event" signal

    -
    gboolean            user_function                      (ClutterStage *stage,
    -                                                        ClutterEvent *event,
    -                                                        gpointer      user_data)      : Run Last
    +
    gboolean            user_function                      (ClutterStage *stage,
    +                                                        ClutterEvent *event,
    +                                                        gpointer      user_data)      : Run Last

    The ::delete-event signal is emitted when the user closes a ClutterStage window using the window controls. @@ -1576,7 +1843,7 @@

    It is possible to override the default behaviour by connecting -a new handler and returning TRUE there. +a new handler and returning TRUE there.

    @@ -1584,6 +1851,8 @@

    Note

    This signal is emitted only on Clutter backends that embed ClutterStage in native windows. It is not emitted for backends that use a static frame buffer.
    +

    +

    @@ -1594,7 +1863,7 @@ - @@ -1603,15 +1872,19 @@

    event :

    a ClutterEvent of type CLUTTER_DELETE + a ClutterEvent of type CLUTTER_DELETE
    -

    Since 1.2

    +

    Since 1.2


    The "fullscreen" signal

    -
    void                user_function                      (ClutterStage *stage,
    -                                                        gpointer      user_data)      : Run First
    +
    void                user_function                      (ClutterStage *stage,
    +                                                        gpointer      user_data)      : Run First

    The ::fullscreen signal is emitted when the stage is made fullscreen.

    +

    +

    @@ -1626,16 +1899,20 @@
    -

    Since 0.6

    +

    Since 0.6


    The "unfullscreen" signal

    -
    void                user_function                      (ClutterStage *stage,
    -                                                        gpointer      user_data)      : Run Last
    +
    void                user_function                      (ClutterStage *stage,
    +                                                        gpointer      user_data)      : Run Last

    The ::unfullscreen signal is emitted when the stage leaves a fullscreen state.

    +

    +

    @@ -1650,12 +1927,12 @@
    -

    Since 0.6

    +

    Since 0.6

    + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/clutter-Unit-conversion.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/clutter-Unit-conversion.html @@ -8,7 +8,7 @@ - + @@ -62,8 +62,8 @@
    Top -  |  - Description +  |  + Description
    @@ -77,43 +77,88 @@

    Synopsis

    -
    enum                ClutterUnitType;
    +
    +enum                ClutterUnitType;
                         ClutterUnits;
    -void                clutter_units_from_cm               (ClutterUnits *units,
    -                                                         gfloat cm);
    -void                clutter_units_from_em               (ClutterUnits *units,
    -                                                         gfloat em);
    -void                clutter_units_from_em_for_font      (ClutterUnits *units,
    -                                                         const gchar *font_name,
    -                                                         gfloat em);
    -void                clutter_units_from_mm               (ClutterUnits *units,
    -                                                         gfloat mm);
    -void                clutter_units_from_pixels           (ClutterUnits *units,
    -                                                         gint px);
    -void                clutter_units_from_pt               (ClutterUnits *units,
    -                                                         gfloat pt);
    -gfloat              clutter_units_to_pixels             (ClutterUnits *units);
    -ClutterUnits *      clutter_units_copy                  (const ClutterUnits *units);
    -void                clutter_units_free                  (ClutterUnits *units);
    -ClutterUnitType     clutter_units_get_unit_type         (const ClutterUnits *units);
    -gfloat              clutter_units_get_unit_value        (const ClutterUnits *units);
    -gboolean            clutter_units_from_string           (ClutterUnits *units,
    -                                                         const gchar *str);
    -gchar *             clutter_units_to_string             (const ClutterUnits *units);
    +void                clutter_units_from_cm               (ClutterUnits *units,
    +                                                         gfloat cm);
    +void                clutter_units_from_em               (ClutterUnits *units,
    +                                                         gfloat em);
    +void                clutter_units_from_em_for_font      (ClutterUnits *units,
    +                                                         const gchar *font_name,
    +                                                         gfloat em);
    +void                clutter_units_from_mm               (ClutterUnits *units,
    +                                                         gfloat mm);
    +void                clutter_units_from_pixels           (ClutterUnits *units,
    +                                                         gint px);
    +void                clutter_units_from_pt               (ClutterUnits *units,
    +                                                         gfloat pt);
    +gfloat              clutter_units_to_pixels             (ClutterUnits *units);
    +ClutterUnits *      clutter_units_copy                  (const ClutterUnits *units);
    +void                clutter_units_free                  (ClutterUnits *units);
    +ClutterUnitType     clutter_units_get_unit_type         (const ClutterUnits *units);
    +gfloat              clutter_units_get_unit_value        (const ClutterUnits *units);
    +gboolean            clutter_units_from_string           (ClutterUnits *units,
    +                                                         const gchar *str);
    +gchar *             clutter_units_to_string             (const ClutterUnits *units);
     
                         ClutterParamSpecUnits;
    -GParamSpec *        clutter_param_spec_units            (const gchar *name,
    -                                                         const gchar *nick,
    -                                                         const gchar *blurb,
    -                                                         ClutterUnitType default_type,
    -                                                         gfloat minimum,
    -                                                         gfloat maximum,
    -                                                         gfloat default_value,
    -                                                         GParamFlags flags);
    -#define             CLUTTER_VALUE_HOLDS_UNITS           (x)
    -void                clutter_value_set_units             (GValue *value,
    -                                                         const ClutterUnits *units);
    -const ClutterUnits * clutter_value_get_units            (const GValue *value);
    +GParamSpec *        clutter_param_spec_units            (const gchar *name,
    +                                                         const gchar *nick,
    +                                                         const gchar *blurb,
    +                                                         ClutterUnitType default_type,
    +                                                         gfloat minimum,
    +                                                         gfloat maximum,
    +                                                         gfloat default_value,
    +                                                         GParamFlags flags);
    +#define             CLUTTER_VALUE_HOLDS_UNITS           (x)
    +void                clutter_value_set_units             (GValue *value,
    +                                                         const ClutterUnits *units);
    +const ClutterUnits * clutter_value_get_units            (const GValue *value);
     
    @@ -123,13 +168,15 @@ its type, expressed as a value of the ClutterUnitType enumeration. It is possible to use ClutterUnits to store a position or a size in units different than pixels, and convert them whenever needed (for instance -inside the ClutterActor::allocate() virtual function, or inside the -ClutterActor::get_preferred_width() and ClutterActor::get_preferred_height() +inside the ""allocate() virtual function, or inside the +""get_preferred_width() and ""get_preferred_height() virtual functions.

    In order to register a ClutterUnits property, the ClutterParamSpecUnits -GParamSpec sub-class should be used: +GParamSpec sub-class should be used:

    @@ -148,14 +195,24 @@

    -A GValue holding units can be manipulated using clutter_value_set_units() -and clutter_value_get_units(). GValues containing a ClutterUnits -value can also be transformed to GValues initialized with -G_TYPE_INT, G_TYPE_FLOAT and G_TYPE_STRING through implicit conversion -and using g_value_transform(). +A GValue holding units can be manipulated using clutter_value_set_units() +and clutter_value_get_units(). GValues containing a ClutterUnits +value can also be transformed to GValues initialized with +G_TYPE_INT, G_TYPE_FLOAT and G_TYPE_STRING through implicit conversion +and using g_value_transform().

    ClutterUnits is available since Clutter 1.0

    +

    +

    Details

    @@ -174,31 +231,33 @@

    This enumeration might be expanded at later date

    +

    +

    - + - + - + - + - + @@ -215,15 +274,21 @@

    An opaque structure, to be used to store sizing and positioning values along with their unit.

    +

    +

    Since 1.0


    clutter_units_from_cm ()

    -
    void                clutter_units_from_cm               (ClutterUnits *units,
    -                                                         gfloat cm);
    +
    void                clutter_units_from_cm               (ClutterUnits *units,
    +                                                         gfloat cm);

    Stores a value in centimeters inside units

    +

    +

    CLUTTER_UNIT_PIXEL

    CLUTTER_UNIT_PIXEL

    Unit expressed in pixels (with subpixel precision)

    CLUTTER_UNIT_EM

    CLUTTER_UNIT_EM

    Unit expressed in em

    CLUTTER_UNIT_MM

    CLUTTER_UNIT_MM

    Unit expressed in millimeters

    CLUTTER_UNIT_POINT

    CLUTTER_UNIT_POINT

    Unit expressed in points

    CLUTTER_UNIT_CM

    CLUTTER_UNIT_CM

    Unit expressed in centimeters
    @@ -244,11 +309,15 @@

    clutter_units_from_em ()

    -
    void                clutter_units_from_em               (ClutterUnits *units,
    -                                                         gfloat em);
    +
    void                clutter_units_from_em               (ClutterUnits *units,
    +                                                         gfloat em);

    Stores a value in em inside units, using the default font name as returned by clutter_backend_get_font_name()

    +

    +

    @@ -269,11 +338,17 @@

    clutter_units_from_em_for_font ()

    -
    void                clutter_units_from_em_for_font      (ClutterUnits *units,
    -                                                         const gchar *font_name,
    -                                                         gfloat em);
    +
    void                clutter_units_from_em_for_font      (ClutterUnits *units,
    +                                                         const gchar *font_name,
    +                                                         gfloat em);

    Stores a value in em inside units using font_name

    +

    +

    @@ -299,10 +374,14 @@

    clutter_units_from_mm ()

    -
    void                clutter_units_from_mm               (ClutterUnits *units,
    -                                                         gfloat mm);
    +
    void                clutter_units_from_mm               (ClutterUnits *units,
    +                                                         gfloat mm);

    Stores a value in millimiters inside units

    +

    +

    @@ -323,10 +402,14 @@

    clutter_units_from_pixels ()

    -
    void                clutter_units_from_pixels           (ClutterUnits *units,
    -                                                         gint px);
    +
    void                clutter_units_from_pixels           (ClutterUnits *units,
    +                                                         gint px);

    Stores a value in pixels inside units

    +

    +

    @@ -347,10 +430,14 @@

    clutter_units_from_pt ()

    -
    void                clutter_units_from_pt               (ClutterUnits *units,
    -                                                         gfloat pt);
    +
    void                clutter_units_from_pt               (ClutterUnits *units,
    +                                                         gfloat pt);

    Stores a value in typographic points inside units

    +

    +

    @@ -371,9 +458,13 @@

    clutter_units_to_pixels ()

    -
    gfloat              clutter_units_to_pixels             (ClutterUnits *units);
    +
    gfloat              clutter_units_to_pixels             (ClutterUnits *units);

    Converts a value in ClutterUnits to pixels

    +

    +

    @@ -395,9 +486,11 @@

    clutter_units_copy ()

    -
    ClutterUnits *      clutter_units_copy                  (const ClutterUnits *units);
    +
    ClutterUnits *      clutter_units_copy                  (const ClutterUnits *units);

    Copies units

    +

    +

    @@ -420,13 +513,15 @@

    clutter_units_free ()

    -
    void                clutter_units_free                  (ClutterUnits *units);
    +
    void                clutter_units_free                  (ClutterUnits *units);

    Frees the resources allocated by units

    You should only call this function on a ClutterUnits created using clutter_units_copy()

    +

    +

    @@ -440,9 +535,11 @@

    clutter_units_get_unit_type ()

    -
    ClutterUnitType     clutter_units_get_unit_type         (const ClutterUnits *units);
    +
    ClutterUnitType     clutter_units_get_unit_type         (const ClutterUnits *units);

    Retrieves the unit type of the value stored inside units

    +

    +

    @@ -464,9 +561,13 @@

    clutter_units_get_unit_value ()

    -
    gfloat              clutter_units_get_unit_value        (const ClutterUnits *units);
    +
    gfloat              clutter_units_get_unit_value        (const ClutterUnits *units);

    Retrieves the value stored inside units

    +

    +

    @@ -488,8 +589,12 @@

    clutter_units_from_string ()

    -
    gboolean            clutter_units_from_string           (ClutterUnits *units,
    -                                                         const gchar *str);
    +
    gboolean            clutter_units_from_string           (ClutterUnits *units,
    +                                                         const gchar *str);

    Parses a value and updates units with it

    @@ -539,6 +644,8 @@

    Note

    If no unit is specified, pixels are assumed.
    +

    +

    @@ -554,8 +661,8 @@ - @@ -566,7 +673,9 @@

    clutter_units_to_string ()

    -
    gchar *             clutter_units_to_string             (const ClutterUnits *units);
    +
    gchar *             clutter_units_to_string             (const ClutterUnits *units);

    Converts units into a string

    @@ -580,6 +689,8 @@

    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.
    +

    +

    Returns :

    TRUE if the string was successfully parsed, - and FALSE otherwise + TRUE if the string was successfully parsed, + and FALSE otherwise
    @@ -591,7 +702,9 @@ @@ -611,27 +724,37 @@ } ClutterParamSpecUnits;

    -GParamSpec subclass for unit based properties.

    +GParamSpec subclass for unit based properties.

    +

    +

    Returns :

    a newly allocated string containing the encoded - ClutterUnits value. Use g_free() to free the string + ClutterUnits value. Use g_free() to free the string
    - + - + - + - + @@ -642,16 +765,36 @@

    clutter_param_spec_units ()

    -
    GParamSpec *        clutter_param_spec_units            (const gchar *name,
    -                                                         const gchar *nick,
    -                                                         const gchar *blurb,
    -                                                         ClutterUnitType default_type,
    -                                                         gfloat minimum,
    -                                                         gfloat maximum,
    -                                                         gfloat default_value,
    -                                                         GParamFlags flags);
    +
    GParamSpec *        clutter_param_spec_units            (const gchar *name,
    +                                                         const gchar *nick,
    +                                                         const gchar *blurb,
    +                                                         ClutterUnitType default_type,
    +                                                         gfloat minimum,
    +                                                         gfloat maximum,
    +                                                         gfloat default_value,
    +                                                         GParamFlags flags);
    +

    +Creates a GParamSpec for properties using ClutterUnits.

    -Creates a GParamSpec for properties using ClutterUnits.

    +

    ClutterUnitType default_type;

    ClutterUnitType default_type;

    default type

    gfloat default_value;

    gfloat default_value;

    default value

    gfloat minimum;

    gfloat minimum;

    lower boundary

    gfloat maximum;

    gfloat maximum;

    higher boundary
    @@ -697,7 +840,9 @@ - @@ -707,16 +852,20 @@
    -

    CLUTTER_VALUE_HOLDS_UNITS()

    +

    CLUTTER_VALUE_HOLDS_UNITS()

    #define CLUTTER_VALUE_HOLDS_UNITS(x)    (G_VALUE_HOLDS ((x), CLUTTER_TYPE_UNITS))
     

    -Evaluates to TRUE if x holds a ClutterUnits value

    +Evaluates to TRUE if x holds a ClutterUnits value

    +

    +

    Returns :

    the newly created GParamSpec + the newly created GParamSpec
    -

    x :

    a GValue + a GValue
    @@ -725,16 +874,22 @@

    clutter_value_set_units ()

    -
    void                clutter_value_set_units             (GValue *value,
    -                                                         const ClutterUnits *units);
    +
    void                clutter_value_set_units             (GValue *value,
    +                                                         const ClutterUnits *units);

    Sets value to units

    +

    +

    - @@ -749,20 +904,28 @@

    clutter_value_get_units ()

    -
    const ClutterUnits * clutter_value_get_units            (const GValue *value);
    +
    const ClutterUnits * clutter_value_get_units            (const GValue *value);

    Gets the ClutterUnits contained in value.

    +

    +

    value :

    a GValue initialized to CLUTTER_TYPE_UNIT + a GValue initialized to CLUTTER_TYPE_UNIT
    - - @@ -774,6 +937,6 @@ + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ch06.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ch06.html @@ -8,7 +8,7 @@ - + @@ -61,7 +61,7 @@

    value :

    a GValue initialized to CLUTTER_TYPE_UNIT + a GValue initialized to CLUTTER_TYPE_UNIT

    Returns :

    the units inside the passed GValue + the units inside the passed GValue

    -Behaviours

    +Behaviours
    ClutterBehaviourDepth — A behaviour controlling the Z position @@ -89,6 +89,6 @@
    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/migrating-ClutterPath.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/migrating-ClutterPath.html @@ -8,7 +8,7 @@ - + @@ -191,6 +191,6 @@
    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/clutterbackends.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/clutterbackends.html @@ -8,7 +8,7 @@ - + @@ -94,6 +94,6 @@
    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ClutterCairoTexture.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ClutterCairoTexture.html @@ -8,7 +8,7 @@ - + @@ -62,14 +62,14 @@ Top -  |  - Description -  |  - Object Hierarchy -  |  - Implemented Interfaces -  |  - Properties +  |  + Description +  |  + Object Hierarchy +  |  + Implemented Interfaces +  |  + Properties
    @@ -83,36 +83,67 @@

    Object Hierarchy

    -  GObject
    -   +----GInitiallyUnowned
    +  GObject
    +   +----GInitiallyUnowned
              +----ClutterActor
                    +----ClutterTexture
                          +----ClutterCairoTexture
    @@ -127,8 +158,12 @@
     

    Properties

    -  "surface-height"           guint                 : Read / Write
    -  "surface-width"            guint                 : Read / Write
    +  "surface-height"           guint                 : Read / Write
    +  "surface-width"            guint                 : Read / Write
     
    @@ -140,13 +175,19 @@ needed.

    -ClutterCairoTexture will provide a cairo_t context by using the +ClutterCairoTexture will provide a cairo_t context by using the clutter_cairo_texture_create() and clutter_cairo_texture_create_region() functions; you can use the Cairo API to draw on the context and then -call cairo_destroy() when done. +call cairo_destroy() when done.

    -As soon as the context is destroyed with cairo_destroy(), the contents +As soon as the context is destroyed with cairo_destroy(), the contents of the surface will be uploaded into the ClutterCairoTexture actor:

    @@ -163,10 +204,14 @@

    -Although a new cairo_t is created each time you call +Although a new cairo_t is created each time you call clutter_cairo_texture_create() or clutter_cairo_texture_create_region(), it uses the same -cairo_surface_t each time. You can call +cairo_surface_t each time. You can call clutter_cairo_texture_clear() to erase the contents between calls.

    @@ -194,6 +239,8 @@

    ClutterCairoTexture is available since Clutter 1.0.

    +

    +

    Details

    @@ -202,6 +249,8 @@
    typedef struct _ClutterCairoTexture ClutterCairoTexture;

    The ClutterCairoTexture struct contains only private data.

    +

    +

    Since 1.0


    @@ -212,16 +261,24 @@

    The ClutterCairoTextureClass struct contains only private data.

    +

    +

    Since 1.0


    clutter_cairo_texture_new ()

    -
    ClutterActor *      clutter_cairo_texture_new           (guint width,
    -                                                         guint height);
    +
    ClutterActor *      clutter_cairo_texture_new           (guint width,
    +                                                         guint height);

    Creates a new ClutterCairoTexture actor, with a surface of width by height pixels.

    +

    +

    @@ -248,12 +305,18 @@

    clutter_cairo_texture_set_surface_size ()

    -
    void                clutter_cairo_texture_set_surface_size
    -                                                        (ClutterCairoTexture *self,
    -                                                         guint width,
    -                                                         guint height);
    +
    void                clutter_cairo_texture_set_surface_size
    +                                                        (ClutterCairoTexture *self,
    +                                                         guint width,
    +                                                         guint height);

    Resizes the Cairo surface used by self to width and height.

    +

    +

    @@ -279,12 +342,18 @@

    clutter_cairo_texture_get_surface_size ()

    -
    void                clutter_cairo_texture_get_surface_size
    -                                                        (ClutterCairoTexture *self,
    -                                                         guint *width,
    -                                                         guint *height);
    +
    void                clutter_cairo_texture_get_surface_size
    +                                                        (ClutterCairoTexture *self,
    +                                                         guint *width,
    +                                                         guint *height);

    Retrieves the surface width and height for self.

    +

    +

    @@ -295,12 +364,12 @@ - - @@ -310,7 +379,9 @@

    clutter_cairo_texture_create ()

    -
    cairo_t *           clutter_cairo_texture_create        (ClutterCairoTexture *self);
    +
    cairo_t *           clutter_cairo_texture_create        (ClutterCairoTexture *self);

    Creates a new Cairo context for the cairo texture. It is similar to using clutter_cairo_texture_create_region() with x_offset @@ -325,6 +396,8 @@ function or from a callback to the "paint" signal.

    +

    +

    width :

    return location for the surface width, or NULL + return location for the surface width, or NULL

    height :

    return location for the surface height, or NULL + return location for the surface height, or NULL
    @@ -335,7 +408,9 @@ - @@ -347,11 +422,21 @@

    clutter_cairo_texture_create_region ()

    -
    cairo_t *           clutter_cairo_texture_create_region (ClutterCairoTexture *self,
    -                                                         gint x_offset,
    -                                                         gint y_offset,
    -                                                         gint width,
    -                                                         gint height);
    +
    cairo_t *           clutter_cairo_texture_create_region (ClutterCairoTexture *self,
    +                                                         gint x_offset,
    +                                                         gint y_offset,
    +                                                         gint width,
    +                                                         gint height);

    Creates a new Cairo context that will updat the region defined by x_offset, y_offset, width and height. @@ -364,6 +449,8 @@ function or from a callback to the "paint" signal.

    +

    +

    Returns :

    a newly created Cairo context. Use cairo_destroy() + a newly created Cairo context. Use cairo_destroy() to upload the contents of the context when done drawing
    @@ -394,7 +481,9 @@ - @@ -406,11 +495,13 @@

    clutter_cairo_texture_clear ()

    -
    void                clutter_cairo_texture_clear         (ClutterCairoTexture *self);
    +
    void                clutter_cairo_texture_clear         (ClutterCairoTexture *self);

    Clears self's internal drawing surface, so that the next upload will replace the previous contents of the ClutterCairoTexture rather than adding to it.

    +

    +

    Returns :

    a newly created Cairo context. Use cairo_destroy() + a newly created Cairo context. Use cairo_destroy() to upload the contents of the context when done drawing
    @@ -424,11 +515,15 @@

    clutter_cairo_set_source_color ()

    -
    void                clutter_cairo_set_source_color      (cairo_t *cr,
    -                                                         const ClutterColor *color);
    +
    void                clutter_cairo_set_source_color      (cairo_t *cr,
    +                                                         const ClutterColor *color);

    Utility function for setting the source color of cr using a ClutterColor.

    +

    +

    @@ -451,27 +546,35 @@

    Property Details

    The "surface-height" property

    -
      "surface-height"           guint                 : Read / Write
    +
      "surface-height"           guint                 : Read / Write

    The height of the Cairo surface used by the ClutterCairoTexture actor, in pixels.

    +

    +

    Default value: 0

    -

    Since 1.0

    +

    Since 1.0


    The "surface-width" property

    -
      "surface-width"            guint                 : Read / Write
    +
      "surface-width"            guint                 : Read / Write

    The width of the Cairo surface used by the ClutterCairoTexture actor, in pixels.

    +

    +

    Default value: 0

    -

    Since 1.0

    +

    Since 1.0

    + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ClutterScore.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ClutterScore.html @@ -8,7 +8,7 @@ - + @@ -62,14 +62,14 @@
    Top -  |  - Description -  |  - Object Hierarchy -  |  - Properties -  |  - Signals +  |  + Description +  |  + Object Hierarchy +  |  + Properties +  |  + Signals
    @@ -83,45 +83,68 @@

    Synopsis

    -
                        ClutterScore;
    +
    +                    ClutterScore;
                         ClutterScoreClass;
    -ClutterScore *      clutter_score_new                   (void);
    -void                clutter_score_set_loop              (ClutterScore *score,
    -                                                         gboolean loop);
    -gboolean            clutter_score_get_loop              (ClutterScore *score);
    -
    -gulong              clutter_score_append                (ClutterScore *score,
    -                                                         ClutterTimeline *parent,
    -                                                         ClutterTimeline *timeline);
    -gulong              clutter_score_append_at_marker      (ClutterScore *score,
    -                                                         ClutterTimeline *parent,
    -                                                         const gchar *marker_name,
    -                                                         ClutterTimeline *timeline);
    -void                clutter_score_remove                (ClutterScore *score,
    -                                                         gulong id);
    -void                clutter_score_remove_all            (ClutterScore *score);
    -ClutterTimeline *   clutter_score_get_timeline          (ClutterScore *score,
    -                                                         gulong id);
    -GSList *            clutter_score_list_timelines        (ClutterScore *score);
    -
    -void                clutter_score_start                 (ClutterScore *score);
    -void                clutter_score_pause                 (ClutterScore *score);
    -void                clutter_score_stop                  (ClutterScore *score);
    -gboolean            clutter_score_is_playing            (ClutterScore *score);
    -void                clutter_score_rewind                (ClutterScore *score);
    +ClutterScore *      clutter_score_new                   (void);
    +void                clutter_score_set_loop              (ClutterScore *score,
    +                                                         gboolean loop);
    +gboolean            clutter_score_get_loop              (ClutterScore *score);
    +
    +gulong              clutter_score_append                (ClutterScore *score,
    +                                                         ClutterTimeline *parent,
    +                                                         ClutterTimeline *timeline);
    +gulong              clutter_score_append_at_marker      (ClutterScore *score,
    +                                                         ClutterTimeline *parent,
    +                                                         const gchar *marker_name,
    +                                                         ClutterTimeline *timeline);
    +void                clutter_score_remove                (ClutterScore *score,
    +                                                         gulong id);
    +void                clutter_score_remove_all            (ClutterScore *score);
    +ClutterTimeline *   clutter_score_get_timeline          (ClutterScore *score,
    +                                                         gulong id);
    +GSList *            clutter_score_list_timelines        (ClutterScore *score);
    +
    +void                clutter_score_start                 (ClutterScore *score);
    +void                clutter_score_pause                 (ClutterScore *score);
    +void                clutter_score_stop                  (ClutterScore *score);
    +gboolean            clutter_score_is_playing            (ClutterScore *score);
    +void                clutter_score_rewind                (ClutterScore *score);
     

    Object Hierarchy

    -  GObject
    +  GObject
        +----ClutterScore
     

    Properties

    -  "loop"                     gboolean              : Read / Write
    +  "loop"                     gboolean              : Read / Write
     
    @@ -196,6 +219,8 @@

    ClutterScore is available since Clutter 0.6

    +

    +

    Details

    @@ -205,6 +230,8 @@

    The ClutterScore structure contains only private data and should be accessed using the provided API

    +

    +

    Since 0.6


    @@ -223,32 +250,34 @@

    The ClutterScoreClass structure contains only private data

    +

    +

    - + - + - + - + - + @@ -259,15 +288,19 @@

    clutter_score_new ()

    -
    ClutterScore *      clutter_score_new                   (void);
    +
    ClutterScore *      clutter_score_new                   (void);

    Creates a new ClutterScore. A ClutterScore is an object that can hold multiple ClutterTimelines in a sequential order.

    +

    +

    timeline_started ()

    timeline_started ()

    handler for the "timeline-started" signal

    timeline_completed ()

    timeline_completed ()

    handler for the "timeline-completed" signal

    started ()

    started ()

    handler for the "started" signal

    completed ()

    completed ()

    handler for the "completed" signal

    paused ()

    paused ()

    handler for the "paused" signal
    - @@ -278,11 +311,15 @@

    clutter_score_set_loop ()

    -
    void                clutter_score_set_loop              (ClutterScore *score,
    -                                                         gboolean loop);
    +
    void                clutter_score_set_loop              (ClutterScore *score,
    +                                                         gboolean loop);

    Sets whether score should loop. A looping ClutterScore will start from its initial state after the ::complete signal has been fired.

    +

    +

    Returns :

    the newly created ClutterScore. Use g_object_unref() + the newly created ClutterScore. Use g_object_unref() when done.
    @@ -293,7 +330,7 @@ - @@ -303,9 +340,13 @@

    clutter_score_get_loop ()

    -
    gboolean            clutter_score_get_loop              (ClutterScore *score);
    +
    gboolean            clutter_score_get_loop              (ClutterScore *score);

    Gets whether score is looping

    +

    +

    loop :

    TRUE for enable looping + TRUE for enable looping
    @@ -316,7 +357,7 @@ - @@ -327,19 +368,23 @@

    clutter_score_append ()

    -
    gulong              clutter_score_append                (ClutterScore *score,
    -                                                         ClutterTimeline *parent,
    -                                                         ClutterTimeline *timeline);
    +
    gulong              clutter_score_append                (ClutterScore *score,
    +                                                         ClutterTimeline *parent,
    +                                                         ClutterTimeline *timeline);

    Appends a timeline to another one existing in the score; the newly appended timeline will be started when parent is complete.

    -If parent is NULL, the new ClutterTimeline will be started when +If parent is NULL, the new ClutterTimeline will be started when clutter_score_start() is called.

    ClutterScore will take a reference on timeline.

    +

    +

    Returns :

    TRUE if the score is looping + TRUE if the score is looping
    @@ -350,7 +395,7 @@ - @@ -373,10 +418,14 @@

    clutter_score_append_at_marker ()

    -
    gulong              clutter_score_append_at_marker      (ClutterScore *score,
    -                                                         ClutterTimeline *parent,
    -                                                         const gchar *marker_name,
    -                                                         ClutterTimeline *timeline);
    +
    gulong              clutter_score_append_at_marker      (ClutterScore *score,
    +                                                         ClutterTimeline *parent,
    +                                                         const gchar *marker_name,
    +                                                         ClutterTimeline *timeline);

    Appends timeline at the given marker_name on the parent ClutterTimeline. @@ -387,6 +436,8 @@

    The ClutterScore will take a reference on timeline.

    +

    +

    parent :

    a ClutterTimeline in the score, or NULL + a ClutterTimeline in the score, or NULL
    @@ -425,12 +476,16 @@

    clutter_score_remove ()

    -
    void                clutter_score_remove                (ClutterScore *score,
    -                                                         gulong id);
    +
    void                clutter_score_remove                (ClutterScore *score,
    +                                                         gulong id);

    Removes the ClutterTimeline with the given id inside score. If the timeline has other timelines attached to it, those are removed as well.

    +

    +

    @@ -451,9 +506,11 @@

    clutter_score_remove_all ()

    -
    void                clutter_score_remove_all            (ClutterScore *score);
    +
    void                clutter_score_remove_all            (ClutterScore *score);

    Removes all the timelines inside score.

    +

    +

    @@ -467,10 +524,14 @@

    clutter_score_get_timeline ()

    -
    ClutterTimeline *   clutter_score_get_timeline          (ClutterScore *score,
    -                                                         gulong id);
    +
    ClutterTimeline *   clutter_score_get_timeline          (ClutterScore *score,
    +                                                         gulong id);

    Retrieves the ClutterTimeline for id inside score.

    +

    +

    @@ -486,7 +547,7 @@ - +

    Returns :

    transfer none. transfer none. transfer none. transfer none.
    @@ -495,9 +556,13 @@

    clutter_score_list_timelines ()

    -
    GSList *            clutter_score_list_timelines        (ClutterScore *score);
    +
    GSList *            clutter_score_list_timelines        (ClutterScore *score);
    +

    +Retrieves a list of all the ClutterTimelines managed by score.

    -Retrieves a list of all the ClutterTimelines managed by score.

    +

    @@ -508,7 +573,7 @@ - +

    Returns :

    transfer container) (element-type ClutterTimeline. transfer container. element-type ClutterTimeline. transfer container) (element-type ClutterTimeline. transfer container. element-type ClutterTimeline.
    @@ -517,9 +582,11 @@

    clutter_score_start ()

    -
    void                clutter_score_start                 (ClutterScore *score);
    +
    void                clutter_score_start                 (ClutterScore *score);

    Starts the score.

    +

    +

    @@ -533,9 +600,11 @@

    clutter_score_pause ()

    -
    void                clutter_score_pause                 (ClutterScore *score);
    +
    void                clutter_score_pause                 (ClutterScore *score);

    Pauses a playing score score.

    +

    +

    @@ -549,9 +618,11 @@

    clutter_score_stop ()

    -
    void                clutter_score_stop                  (ClutterScore *score);
    +
    void                clutter_score_stop                  (ClutterScore *score);

    Stops and rewinds a playing ClutterScore instance.

    +

    +

    @@ -565,9 +636,13 @@

    clutter_score_is_playing ()

    -
    gboolean            clutter_score_is_playing            (ClutterScore *score);
    +
    gboolean            clutter_score_is_playing            (ClutterScore *score);

    Query state of a ClutterScore instance.

    +

    +

    @@ -578,7 +653,7 @@ - @@ -589,9 +664,11 @@

    clutter_score_rewind ()

    -
    void                clutter_score_rewind                (ClutterScore *score);
    +
    void                clutter_score_rewind                (ClutterScore *score);

    Rewinds a ClutterScore to its initial state.

    +

    +

    Returns :

    TRUE if score is currently playing + TRUE if score is currently playing
    @@ -607,21 +684,29 @@

    Property Details

    The "loop" property

    -
      "loop"                     gboolean              : Read / Write
    +
      "loop"                     gboolean              : Read / Write

    Whether the ClutterScore should restart once finished.

    +

    +

    Default value: FALSE

    -

    Since 0.6

    +

    Since 0.6

    Signal Details

    The "completed" signal

    -
    void                user_function                      (ClutterScore *score,
    -                                                        gpointer      user_data)      : Run Last
    +
    void                user_function                      (ClutterScore *score,
    +                                                        gpointer      user_data)      : Run Last

    The ::completed signal is emitted each time a ClutterScore terminates.

    +

    +

    @@ -636,16 +721,20 @@
    -

    Since 0.6

    +

    Since 0.6


    The "paused" signal

    -
    void                user_function                      (ClutterScore *score,
    -                                                        gpointer      user_data)      : Run Last
    +
    void                user_function                      (ClutterScore *score,
    +                                                        gpointer      user_data)      : Run Last

    The ::paused signal is emitted each time a ClutterScore is paused.

    +

    +

    @@ -660,15 +749,19 @@
    -

    Since 0.6

    +

    Since 0.6


    The "started" signal

    -
    void                user_function                      (ClutterScore *score,
    -                                                        gpointer      user_data)      : Run Last
    +
    void                user_function                      (ClutterScore *score,
    +                                                        gpointer      user_data)      : Run Last

    The ::started signal is emitted each time a ClutterScore starts playing.

    +

    +

    @@ -683,17 +776,21 @@
    -

    Since 0.6

    +

    Since 0.6


    The "timeline-completed" signal

    -
    void                user_function                      (ClutterScore    *score,
    -                                                        ClutterTimeline *timeline,
    -                                                        gpointer         user_data)      : Run Last
    +
    void                user_function                      (ClutterScore    *score,
    +                                                        ClutterTimeline *timeline,
    +                                                        gpointer         user_data)      : Run Last

    The ::timeline-completed signal is emitted each time a timeline inside a ClutterScore terminates.

    +

    +

    @@ -713,17 +810,21 @@
    -

    Since 0.6

    +

    Since 0.6


    The "timeline-started" signal

    -
    void                user_function                      (ClutterScore    *score,
    -                                                        ClutterTimeline *timeline,
    -                                                        gpointer         user_data)      : Run Last
    +
    void                user_function                      (ClutterScore    *score,
    +                                                        ClutterTimeline *timeline,
    +                                                        gpointer         user_data)      : Run Last

    The ::timeline-started signal is emitted each time a new timeline inside a ClutterScore starts playing.

    +

    +

    @@ -743,12 +844,12 @@
    -

    Since 0.6

    +

    Since 0.6

    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ch02.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ch02.html @@ -8,7 +8,7 @@ - + @@ -61,7 +61,7 @@

    -Base actors

    +Base actors
    ClutterRectangle — An actor that displays a simple rectangle. @@ -82,6 +82,6 @@
    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ix04.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ix04.html @@ -8,7 +8,7 @@ - + @@ -52,53 +52,29 @@ - - + - - - +

    -Index of new symbols in 0.4

    -

    A

    +Index of new symbols in 0.4
    +
    + + + +
    +

    D

    +
    clutter_do_event
    -

    E

    +
    +
    + + + +
    +

    M

    +
    ClutterModifierType
    -

    P

    +
    +
    + + + + +
    +

    V

    +
    ClutterVertex
    -

    X

    +
    +
    + +
    +
    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/using-cairo.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/using-cairo.html @@ -8,7 +8,7 @@ - + @@ -71,6 +71,6 @@
    + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ClutterScriptable.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ClutterScriptable.html @@ -8,7 +8,7 @@ - + @@ -62,12 +62,12 @@ Top -  |  - Description -  |  - Object Hierarchy -  |  - Known Implementations +  |  + Description +  |  + Object Hierarchy +  |  + Known Implementations
    @@ -81,22 +81,37 @@

    Synopsis

    -
                        ClutterScriptable;
    +
    +                    ClutterScriptable;
                         ClutterScriptableIface;
    -void                clutter_scriptable_set_id           (ClutterScriptable *scriptable,
    -                                                         const gchar *id);
    -const gchar *       clutter_scriptable_get_id           (ClutterScriptable *scriptable);
    -gboolean            clutter_scriptable_parse_custom_node
    -                                                        (ClutterScriptable *scriptable,
    -                                                         ClutterScript *script,
    -                                                         GValue *value,
    -                                                         const gchar *name,
    -                                                         JsonNode *node);
    -void                clutter_scriptable_set_custom_property
    -                                                        (ClutterScriptable *scriptable,
    -                                                         ClutterScript *script,
    -                                                         const gchar *name,
    -                                                         const GValue *value);
    +void                clutter_scriptable_set_id           (ClutterScriptable *scriptable,
    +                                                         const gchar *id);
    +const gchar *       clutter_scriptable_get_id           (ClutterScriptable *scriptable);
    +gboolean            clutter_scriptable_parse_custom_node
    +                                                        (ClutterScriptable *scriptable,
    +                                                         ClutterScript *script,
    +                                                         GValue *value,
    +                                                         const gchar *name,
    +                                                         JsonNode *node);
    +void                clutter_scriptable_set_custom_property
    +                                                        (ClutterScriptable *scriptable,
    +                                                         ClutterScript *script,
    +                                                         const gchar *name,
    +                                                         const GValue *value);
     
    @@ -122,6 +137,8 @@

    ClutterScriptable is available since Clutter 0.6

    +

    +

    Details

    @@ -131,6 +148,8 @@

    ClutterScriptable is an opaque structure whose members cannot be directly accessed

    +

    +

    Since 0.6


    @@ -156,27 +175,29 @@ Interface for implementing "scriptable" objects. An object implementing this interface can override the parsing and properties setting sequence when loading a UI definition data with ClutterScript

    +

    +

    - + - + - + - + @@ -187,8 +208,10 @@

    clutter_scriptable_set_id ()

    -
    void                clutter_scriptable_set_id           (ClutterScriptable *scriptable,
    -                                                         const gchar *id);
    +
    void                clutter_scriptable_set_id           (ClutterScriptable *scriptable,
    +                                                         const gchar *id);

    Sets id as the unique Clutter script it for this instance of ClutterScriptableIface. @@ -197,6 +220,8 @@ This name can be used by user interface designer applications to define a unique name for an object constructable using the UI definition language parsed by ClutterScript.

    +

    +

    set_id ()

    set_id ()

    virtual function for setting the id of a scriptable object

    get_id ()

    get_id ()

    virtual function for getting the id of a scriptable object

    parse_custom_node ()

    parse_custom_node ()

    virtual function for parsing complex data containers into GObject properties

    set_custom_property ()

    set_custom_property ()

    virtual function for setting a custom property
    @@ -217,9 +242,13 @@

    clutter_scriptable_get_id ()

    -
    const gchar *       clutter_scriptable_get_id           (ClutterScriptable *scriptable);
    +
    const gchar *       clutter_scriptable_get_id           (ClutterScriptable *scriptable);

    Retrieves the id of scriptable set using clutter_scriptable_set_id().

    +

    +

    @@ -242,15 +271,27 @@

    clutter_scriptable_parse_custom_node ()

    -
    gboolean            clutter_scriptable_parse_custom_node
    -                                                        (ClutterScriptable *scriptable,
    -                                                         ClutterScript *script,
    -                                                         GValue *value,
    -                                                         const gchar *name,
    -                                                         JsonNode *node);
    +
    gboolean            clutter_scriptable_parse_custom_node
    +                                                        (ClutterScriptable *scriptable,
    +                                                         ClutterScript *script,
    +                                                         GValue *value,
    +                                                         const gchar *name,
    +                                                         JsonNode *node);

    Parses the passed JSON node. The implementation must set the type -of the passed GValue pointer using g_value_init().

    +of the passed GValue pointer using g_value_init().

    +

    +

    @@ -281,7 +322,7 @@ - @@ -292,14 +333,20 @@

    clutter_scriptable_set_custom_property ()

    -
    void                clutter_scriptable_set_custom_property
    -                                                        (ClutterScriptable *scriptable,
    -                                                         ClutterScript *script,
    -                                                         const gchar *name,
    -                                                         const GValue *value);
    +
    void                clutter_scriptable_set_custom_property
    +                                                        (ClutterScriptable *scriptable,
    +                                                         ClutterScript *script,
    +                                                         const gchar *name,
    +                                                         const GValue *value);

    Overrides the common properties setting. The underlying virtual function should be used when implementing custom properties.

    +

    +

    Returns :

    TRUE if the node was successfully parsed, FALSE otherwise. + TRUE if the node was successfully parsed, FALSE otherwise.
    @@ -331,6 +378,6 @@ + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/clutterobjects.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/clutterobjects.html @@ -8,7 +8,7 @@ - + @@ -72,6 +72,6 @@ + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/clutter-Stage-Manager.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/clutter-Stage-Manager.html @@ -8,7 +8,7 @@ - + @@ -62,14 +62,14 @@
    Top -  |  - Description -  |  - Object Hierarchy -  |  - Properties -  |  - Signals +  |  + Description +  |  + Object Hierarchy +  |  + Properties +  |  + Signals
    @@ -83,29 +83,36 @@

    Synopsis

    -
                        ClutterStageManager;
    +
    +                    ClutterStageManager;
                         ClutterStageManagerClass;
    -ClutterStageManager * clutter_stage_manager_get_default (void);
    -void                clutter_stage_manager_set_default_stage
    -                                                        (ClutterStageManager *stage_manager,
    -                                                         ClutterStage *stage);
    -ClutterStage *      clutter_stage_manager_get_default_stage
    -                                                        (ClutterStageManager *stage_manager);
    -GSList *            clutter_stage_manager_list_stages   (ClutterStageManager *stage_manager);
    -const GSList *      clutter_stage_manager_peek_stages   (ClutterStageManager *stage_manager);
    +ClutterStageManager * clutter_stage_manager_get_default (void);
    +void                clutter_stage_manager_set_default_stage
    +                                                        (ClutterStageManager *stage_manager,
    +                                                         ClutterStage *stage);
    +ClutterStage *      clutter_stage_manager_get_default_stage
    +                                                        (ClutterStageManager *stage_manager);
    +GSList *            clutter_stage_manager_list_stages   (ClutterStageManager *stage_manager);
    +const GSList *      clutter_stage_manager_peek_stages   (ClutterStageManager *stage_manager);
     

    Object Hierarchy

    -  GObject
    +  GObject
        +----ClutterStageManager
     

    Properties

    -  "default-stage"            ClutterStage*         : Read
    +  "default-stage"            ClutterStage*         : Read
     
    @@ -129,6 +136,8 @@

    ClutterStageManager is available since Clutter 0.8

    +

    +

    Details

    @@ -137,6 +146,8 @@
    typedef struct _ClutterStageManager ClutterStageManager;

    The ClutterStageManager structure is private.

    +

    +

    Since 1.0


    @@ -148,6 +159,8 @@

    The ClutterStageManagerClass structure contains only private data and should be accessed using the provided API

    +

    +

    @@ -157,14 +170,16 @@

    clutter_stage_manager_get_default ()

    -
    ClutterStageManager * clutter_stage_manager_get_default (void);
    +
    ClutterStageManager * clutter_stage_manager_get_default (void);

    Returns the default ClutterStageManager.

    +

    +

    - +

    Returns :

    transfer none. transfer none. transfer none. transfer none.

    Since 0.8

    @@ -172,15 +187,17 @@

    clutter_stage_manager_set_default_stage ()

    -
    void                clutter_stage_manager_set_default_stage
    -                                                        (ClutterStageManager *stage_manager,
    -                                                         ClutterStage *stage);
    +
    void                clutter_stage_manager_set_default_stage
    +                                                        (ClutterStageManager *stage_manager,
    +                                                         ClutterStage *stage);

    Warning

    clutter_stage_manager_set_default_stage has been deprecated since version 1.2 and should not be used in newly-written code. Calling this function has no effect

    Sets stage as the default stage.

    +

    +

    @@ -201,10 +218,12 @@

    clutter_stage_manager_get_default_stage ()

    -
    ClutterStage *      clutter_stage_manager_get_default_stage
    -                                                        (ClutterStageManager *stage_manager);
    +
    ClutterStage *      clutter_stage_manager_get_default_stage
    +                                                        (ClutterStageManager *stage_manager);

    Returns the default ClutterStage.

    +

    +

    @@ -215,7 +234,7 @@ - +

    Returns :

    transfer none. transfer none. transfer none. transfer none.
    @@ -224,9 +243,13 @@

    clutter_stage_manager_list_stages ()

    -
    GSList *            clutter_stage_manager_list_stages   (ClutterStageManager *stage_manager);
    +
    GSList *            clutter_stage_manager_list_stages   (ClutterStageManager *stage_manager);

    Lists all currently used stages.

    +

    +

    @@ -237,7 +260,7 @@ - +

    Returns :

    transfer container) (element-type ClutterStage. transfer container. element-type ClutterStage. transfer container) (element-type ClutterStage. transfer container. element-type ClutterStage.
    @@ -246,9 +269,13 @@

    clutter_stage_manager_peek_stages ()

    -
    const GSList *      clutter_stage_manager_peek_stages   (ClutterStageManager *stage_manager);
    +
    const GSList *      clutter_stage_manager_peek_stages   (ClutterStageManager *stage_manager);

    Lists all currently used stages.

    +

    +

    @@ -259,7 +286,7 @@ - +

    Returns :

    transfer none) (element-type ClutterStage. transfer none. element-type ClutterStage. transfer none) (element-type ClutterStage. transfer none. element-type ClutterStage.
    @@ -270,22 +297,28 @@

    Property Details

    The "default-stage" property

    -
      "default-stage"            ClutterStage*         : Read
    +
      "default-stage"            ClutterStage*         : Read

    The default stage used by Clutter.

    -

    Since 0.8

    +

    +

    +

    Since 0.8

    Signal Details

    The "stage-added" signal

    -
    void                user_function                      (ClutterStageManager *stage_manager,
    -                                                        ClutterStage        *stage,
    -                                                        gpointer             user_data)          : Run Last
    +
    void                user_function                      (ClutterStageManager *stage_manager,
    +                                                        ClutterStage        *stage,
    +                                                        gpointer             user_data)          : Run Last

    The ::stage-added signal is emitted each time a new ClutterStage has been added to the stage manager.

    +

    +

    @@ -305,17 +338,21 @@
    -

    Since 0.8

    +

    Since 0.8


    The "stage-removed" signal

    -
    void                user_function                      (ClutterStageManager *stage_manager,
    -                                                        ClutterStage        *stage,
    -                                                        gpointer             user_data)          : Run Last
    +
    void                user_function                      (ClutterStageManager *stage_manager,
    +                                                        ClutterStage        *stage,
    +                                                        gpointer             user_data)          : Run Last

    The ::stage-removed signal is emitted each time a ClutterStage has been removed from the stage manager.

    +

    +

    @@ -335,12 +372,12 @@
    -

    Since 0.8

    +

    Since 0.8

    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/clutter-Colors.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/clutter-Colors.html @@ -8,7 +8,7 @@ - + @@ -62,8 +62,8 @@ Top -  |  - Description +  |  + Description
    @@ -77,56 +77,113 @@

    Synopsis

    -
                        ClutterColor;
    -ClutterColor *      clutter_color_new                   (guint8 red,
    -                                                         guint8 green,
    -                                                         guint8 blue,
    -                                                         guint8 alpha);
    -ClutterColor *      clutter_color_copy                  (const ClutterColor *color);
    -void                clutter_color_free                  (ClutterColor *color);
    -gboolean            clutter_color_equal                 (gconstpointer v1,
    -                                                         gconstpointer v2);
    -guint               clutter_color_hash                  (gconstpointer v);
    -
    -gboolean            clutter_color_from_string           (ClutterColor *color,
    -                                                         const gchar *str);
    -gchar *             clutter_color_to_string             (const ClutterColor *color);
    -void                clutter_color_from_hls              (ClutterColor *color,
    -                                                         gfloat hue,
    -                                                         gfloat luminance,
    -                                                         gfloat saturation);
    -void                clutter_color_to_hls                (const ClutterColor *color,
    -                                                         gfloat *hue,
    -                                                         gfloat *luminance,
    -                                                         gfloat *saturation);
    -void                clutter_color_from_pixel            (ClutterColor *color,
    -                                                         guint32 pixel);
    -guint32             clutter_color_to_pixel              (const ClutterColor *color);
    -
    -void                clutter_color_add                   (const ClutterColor *a,
    -                                                         const ClutterColor *b,
    -                                                         ClutterColor *result);
    -void                clutter_color_subtract              (const ClutterColor *a,
    -                                                         const ClutterColor *b,
    -                                                         ClutterColor *result);
    -void                clutter_color_lighten               (const ClutterColor *color,
    -                                                         ClutterColor *result);
    -void                clutter_color_darken                (const ClutterColor *color,
    -                                                         ClutterColor *result);
    -void                clutter_color_shade                 (const ClutterColor *color,
    -                                                         gdouble factor,
    -                                                         ClutterColor *result);
    +
    +                    ClutterColor;
    +ClutterColor *      clutter_color_new                   (guint8 red,
    +                                                         guint8 green,
    +                                                         guint8 blue,
    +                                                         guint8 alpha);
    +ClutterColor *      clutter_color_copy                  (const ClutterColor *color);
    +void                clutter_color_free                  (ClutterColor *color);
    +gboolean            clutter_color_equal                 (gconstpointer v1,
    +                                                         gconstpointer v2);
    +guint               clutter_color_hash                  (gconstpointer v);
    +
    +gboolean            clutter_color_from_string           (ClutterColor *color,
    +                                                         const gchar *str);
    +gchar *             clutter_color_to_string             (const ClutterColor *color);
    +void                clutter_color_from_hls              (ClutterColor *color,
    +                                                         gfloat hue,
    +                                                         gfloat luminance,
    +                                                         gfloat saturation);
    +void                clutter_color_to_hls                (const ClutterColor *color,
    +                                                         gfloat *hue,
    +                                                         gfloat *luminance,
    +                                                         gfloat *saturation);
    +void                clutter_color_from_pixel            (ClutterColor *color,
    +                                                         guint32 pixel);
    +guint32             clutter_color_to_pixel              (const ClutterColor *color);
    +
    +void                clutter_color_add                   (const ClutterColor *a,
    +                                                         const ClutterColor *b,
    +                                                         ClutterColor *result);
    +void                clutter_color_subtract              (const ClutterColor *a,
    +                                                         const ClutterColor *b,
    +                                                         ClutterColor *result);
    +void                clutter_color_lighten               (const ClutterColor *color,
    +                                                         ClutterColor *result);
    +void                clutter_color_darken                (const ClutterColor *color,
    +                                                         ClutterColor *result);
    +void                clutter_color_shade                 (const ClutterColor *color,
    +                                                         gdouble factor,
    +                                                         ClutterColor *result);
     
                         ClutterParamSpecColor;
    -GParamSpec *        clutter_param_spec_color            (const gchar *name,
    -                                                         const gchar *nick,
    -                                                         const gchar *blurb,
    -                                                         const ClutterColor *default_value,
    -                                                         GParamFlags flags);
    -#define             CLUTTER_VALUE_HOLDS_COLOR           (x)
    -void                clutter_value_set_color             (GValue *value,
    -                                                         const ClutterColor *color);
    -const ClutterColor * clutter_value_get_color            (const GValue *value);
    +GParamSpec *        clutter_param_spec_color            (const gchar *name,
    +                                                         const gchar *nick,
    +                                                         const gchar *blurb,
    +                                                         const ClutterColor *default_value,
    +                                                         GParamFlags flags);
    +#define             CLUTTER_VALUE_HOLDS_COLOR           (x)
    +void                clutter_value_set_color             (GValue *value,
    +                                                         const ClutterColor *color);
    +const ClutterColor * clutter_value_get_color            (const GValue *value);
     
    @@ -140,6 +197,8 @@

    The alpha channel is fully opaque at 255 and fully transparent at 0.

    +

    +

    Details

    @@ -155,26 +214,36 @@

    Color representation.

    +

    +

    - + - + - + - + @@ -184,12 +253,22 @@

    clutter_color_new ()

    -
    ClutterColor *      clutter_color_new                   (guint8 red,
    -                                                         guint8 green,
    -                                                         guint8 blue,
    -                                                         guint8 alpha);
    +
    ClutterColor *      clutter_color_new                   (guint8 red,
    +                                                         guint8 green,
    +                                                         guint8 blue,
    +                                                         guint8 alpha);

    Creates a new ClutterColor with the given values.

    +

    +

    guint8 red;

    guint8 red;

    red component, between 0 and 255

    guint8 green;

    guint8 green;

    green component, between 0 and 255

    guint8 blue;

    guint8 blue;

    blue component, between 0 and 255

    guint8 alpha;

    guint8 alpha;

    alpha component, between 0 and 255
    @@ -227,10 +306,12 @@

    clutter_color_copy ()

    -
    ClutterColor *      clutter_color_copy                  (const ClutterColor *color);
    +
    ClutterColor *      clutter_color_copy                  (const ClutterColor *color);

    Makes a copy of the color structure. The result must be freed using clutter_color_free().

    +

    +

    @@ -252,9 +333,11 @@

    clutter_color_free ()

    -
    void                clutter_color_free                  (ClutterColor *color);
    +
    void                clutter_color_free                  (ClutterColor *color);

    Frees a color structure created with clutter_color_copy().

    +

    +

    @@ -268,14 +351,26 @@

    clutter_color_equal ()

    -
    gboolean            clutter_color_equal                 (gconstpointer v1,
    -                                                         gconstpointer v2);
    +
    gboolean            clutter_color_equal                 (gconstpointer v1,
    +                                                         gconstpointer v2);

    Compares two ClutterColors 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 ClutterColors as keys in a GHashTable.

    +This function can be passed to g_hash_table_new() as the key_equal_func +parameter, when using ClutterColors as keys in a GHashTable.

    +

    +

    @@ -291,7 +386,7 @@ - @@ -302,13 +397,23 @@

    clutter_color_hash ()

    -
    guint               clutter_color_hash                  (gconstpointer v);
    +
    guint               clutter_color_hash                  (gconstpointer v);

    Converts a ClutterColor to a hash value.

    -This function can be passed to g_hash_table_new() as the hash_func -parameter, when using ClutterColors as keys in a GHashTable.

    +This function can be passed to g_hash_table_new() as the hash_func +parameter, when using ClutterColors as keys in a GHashTable.

    +

    +

    Returns :

    TRUE if the two colors are the same. + TRUE if the two colors are the same.
    @@ -330,8 +435,12 @@

    clutter_color_from_string ()

    -
    gboolean            clutter_color_from_string           (ClutterColor *color,
    -                                                         const gchar *str);
    +
    gboolean            clutter_color_from_string           (ClutterColor *color,
    +                                                         const gchar *str);

    Parses a string definition of a color, filling the red, green, @@ -347,12 +456,14 @@ Red or DarkSlateGray, or hexadecimal specifications like #3050b2 or #333.

    +

    +

    - + @@ -361,7 +472,7 @@ - @@ -372,13 +483,17 @@

    clutter_color_to_string ()

    -
    gchar *             clutter_color_to_string             (const ClutterColor *color);
    +
    gchar *             clutter_color_to_string             (const ClutterColor *color);

    Returns a textual specification of color in the hexadecimal form #rrggbbaa, where r, g, b and a are hex digits representing the red, green, blue and alpha components respectively.

    +

    +

    color :

    return location for a ClutterColor. out. return location for a ClutterColor. out.

    str :

    Returns :

    TRUE if parsing succeeded. + TRUE if parsing succeeded.
    @@ -400,19 +515,27 @@

    clutter_color_from_hls ()

    -
    void                clutter_color_from_hls              (ClutterColor *color,
    -                                                         gfloat hue,
    -                                                         gfloat luminance,
    -                                                         gfloat saturation);
    +
    void                clutter_color_from_hls              (ClutterColor *color,
    +                                                         gfloat hue,
    +                                                         gfloat luminance,
    +                                                         gfloat saturation);

    Converts a color expressed in HLS (hue, luminance and saturation) values into a ClutterColor.

    +

    +

    - + @@ -435,16 +558,24 @@

    clutter_color_to_hls ()

    -
    void                clutter_color_to_hls                (const ClutterColor *color,
    -                                                         gfloat *hue,
    -                                                         gfloat *luminance,
    -                                                         gfloat *saturation);
    +
    void                clutter_color_to_hls                (const ClutterColor *color,
    +                                                         gfloat *hue,
    +                                                         gfloat *luminance,
    +                                                         gfloat *saturation);

    Converts color to the HLS format.

    The hue value is in the 0 .. 360 range. The luminance and saturation values are in the 0 .. 1 range.

    +

    +

    color :

    return location for a ClutterColor. out. return location for a ClutterColor. out.

    hue :

    @@ -455,17 +586,17 @@ - - - @@ -474,17 +605,21 @@

    clutter_color_from_pixel ()

    -
    void                clutter_color_from_pixel            (ClutterColor *color,
    -                                                         guint32 pixel);
    +
    void                clutter_color_from_pixel            (ClutterColor *color,
    +                                                         guint32 pixel);

    Converts pixel from the packed representation of a four 8 bit channel color to a ClutterColor.

    +

    +

    hue :

    return location for the hue value or NULL + return location for the hue value or NULL

    luminance :

    return location for the luminance value or NULL + return location for the luminance value or NULL

    saturation :

    return location for the saturation value or NULL + return location for the saturation value or NULL
    - + @@ -497,10 +632,14 @@

    clutter_color_to_pixel ()

    -
    guint32             clutter_color_to_pixel              (const ClutterColor *color);
    +
    guint32             clutter_color_to_pixel              (const ClutterColor *color);

    Converts color into a packed 32 bit integer, containing all the four 8 bit channels used by ClutterColor.

    +

    +

    color :

    return location for a ClutterColor. out. return location for a ClutterColor. out.

    pixel :

    @@ -520,15 +659,17 @@

    clutter_color_add ()

    -
    void                clutter_color_add                   (const ClutterColor *a,
    -                                                         const ClutterColor *b,
    -                                                         ClutterColor *result);
    +
    void                clutter_color_add                   (const ClutterColor *a,
    +                                                         const ClutterColor *b,
    +                                                         ClutterColor *result);

    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.

    +

    +

    @@ -544,7 +685,7 @@ - +

    result :

    return location for the result. out. return location for the result. out.
    @@ -552,9 +693,9 @@

    clutter_color_subtract ()

    -
    void                clutter_color_subtract              (const ClutterColor *a,
    -                                                         const ClutterColor *b,
    -                                                         ClutterColor *result);
    +
    void                clutter_color_subtract              (const ClutterColor *a,
    +                                                         const ClutterColor *b,
    +                                                         ClutterColor *result);

    Subtracts b from a and saves the resulting color inside result.

    @@ -565,6 +706,8 @@

    The alpha channel of result is set as the minimum value between the alpha channels of a and b.

    +

    +

    @@ -580,7 +723,7 @@ - +

    result :

    return location for the result. out. return location for the result. out.
    @@ -588,11 +731,13 @@

    clutter_color_lighten ()

    -
    void                clutter_color_lighten               (const ClutterColor *color,
    -                                                         ClutterColor *result);
    +
    void                clutter_color_lighten               (const ClutterColor *color,
    +                                                         ClutterColor *result);

    Lightens color by a fixed amount, and saves the changed color in result.

    +

    +

    @@ -603,7 +748,7 @@ - +

    result :

    return location for the lighter color. out. return location for the lighter color. out.
    @@ -611,11 +756,13 @@

    clutter_color_darken ()

    -
    void                clutter_color_darken                (const ClutterColor *color,
    -                                                         ClutterColor *result);
    +
    void                clutter_color_darken                (const ClutterColor *color,
    +                                                         ClutterColor *result);

    Darkens color by a fixed amount, and saves the changed color in result.

    +

    +

    @@ -626,7 +773,7 @@ - +

    result :

    return location for the darker color. out. return location for the darker color. out.
    @@ -634,11 +781,15 @@

    clutter_color_shade ()

    -
    void                clutter_color_shade                 (const ClutterColor *color,
    -                                                         gdouble factor,
    -                                                         ClutterColor *result);
    +
    void                clutter_color_shade                 (const ClutterColor *color,
    +                                                         gdouble factor,
    +                                                         ClutterColor *result);

    Shades color by factor and saves the modified color into result.

    +

    +

    @@ -654,7 +805,7 @@ - +

    result :

    return location for the shaded color. out. return location for the shaded color. out.
    @@ -667,12 +818,16 @@ } ClutterParamSpecColor;

    -A GParamSpec subclass for defining properties holding +A GParamSpec subclass for defining properties holding a ClutterColor.

    +

    +

    - + @@ -682,13 +837,27 @@

    clutter_param_spec_color ()

    -
    GParamSpec *        clutter_param_spec_color            (const gchar *name,
    -                                                         const gchar *nick,
    -                                                         const gchar *blurb,
    -                                                         const ClutterColor *default_value,
    -                                                         GParamFlags flags);
    +
    GParamSpec *        clutter_param_spec_color            (const gchar *name,
    +                                                         const gchar *nick,
    +                                                         const gchar *blurb,
    +                                                         const ClutterColor *default_value,
    +                                                         GParamFlags flags);
    +

    +Creates a GParamSpec for properties using ClutterColor.

    -Creates a GParamSpec for properties using ClutterColor.

    +

    ClutterColor *default_value;

    ClutterColor *default_value;

    default color value
    @@ -719,7 +888,9 @@ - @@ -729,16 +900,20 @@
    -

    CLUTTER_VALUE_HOLDS_COLOR()

    +

    CLUTTER_VALUE_HOLDS_COLOR()

    #define CLUTTER_VALUE_HOLDS_COLOR(x)       (G_VALUE_HOLDS ((x), CLUTTER_TYPE_COLOR))
     

    -Evaluates to TRUE if x holds a ClutterColor.

    +Evaluates to TRUE if x holds a ClutterColor.

    +

    +

    Returns :

    the newly created GParamSpec + the newly created GParamSpec
    -

    x :

    a GValue + a GValue
    @@ -747,16 +922,22 @@

    clutter_value_set_color ()

    -
    void                clutter_value_set_color             (GValue *value,
    -                                                         const ClutterColor *color);
    +
    void                clutter_value_set_color             (GValue *value,
    +                                                         const ClutterColor *color);

    Sets value to color.

    +

    +

    - @@ -771,20 +952,28 @@

    clutter_value_get_color ()

    -
    const ClutterColor * clutter_value_get_color            (const GValue *value);
    +
    const ClutterColor * clutter_value_get_color            (const GValue *value);

    Gets the ClutterColor contained in value.

    +

    +

    value :

    a GValue initialized to CLUTTER_TYPE_COLOR + a GValue initialized to CLUTTER_TYPE_COLOR
    - - @@ -796,6 +985,6 @@ + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ClutterBehaviourRotate.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ClutterBehaviourRotate.html @@ -8,7 +8,7 @@ - + @@ -62,14 +62,14 @@

    value :

    a GValue initialized to CLUTTER_TYPE_COLOR + a GValue initialized to CLUTTER_TYPE_COLOR

    Returns :

    the colors inside the passed GValue + the colors inside the passed GValue
    Top -  |  - Description -  |  - Object Hierarchy -  |  - Implemented Interfaces -  |  - Properties +  |  + Description +  |  + Object Hierarchy +  |  + Implemented Interfaces +  |  + Properties
    @@ -83,43 +83,70 @@

    Synopsis

    -
    enum                ClutterRotateAxis;
    +
    +enum                ClutterRotateAxis;
     enum                ClutterRotateDirection;
                         ClutterBehaviourRotate;
                         ClutterBehaviourRotateClass;
    -ClutterBehaviour *  clutter_behaviour_rotate_new        (ClutterAlpha *alpha,
    -                                                         ClutterRotateAxis axis,
    -                                                         ClutterRotateDirection direction,
    -                                                         gdouble angle_start,
    -                                                         gdouble angle_end);
    -void                clutter_behaviour_rotate_set_axis   (ClutterBehaviourRotate *rotate,
    -                                                         ClutterRotateAxis axis);
    -ClutterRotateAxis   clutter_behaviour_rotate_get_axis   (ClutterBehaviourRotate *rotate);
    -void                clutter_behaviour_rotate_set_direction
    -                                                        (ClutterBehaviourRotate *rotate,
    -                                                         ClutterRotateDirection direction);
    -ClutterRotateDirection  clutter_behaviour_rotate_get_direction
    -                                                        (ClutterBehaviourRotate *rotate);
    -void                clutter_behaviour_rotate_set_bounds (ClutterBehaviourRotate *rotate,
    -                                                         gdouble angle_start,
    -                                                         gdouble angle_end);
    -void                clutter_behaviour_rotate_get_bounds (ClutterBehaviourRotate *rotate,
    -                                                         gdouble *angle_start,
    -                                                         gdouble *angle_end);
    -void                clutter_behaviour_rotate_set_center (ClutterBehaviourRotate *rotate,
    -                                                         gint x,
    -                                                         gint y,
    -                                                         gint z);
    -void                clutter_behaviour_rotate_get_center (ClutterBehaviourRotate *rotate,
    -                                                         gint *x,
    -                                                         gint *y,
    -                                                         gint *z);
    +ClutterBehaviour *  clutter_behaviour_rotate_new        (ClutterAlpha *alpha,
    +                                                         ClutterRotateAxis axis,
    +                                                         ClutterRotateDirection direction,
    +                                                         gdouble angle_start,
    +                                                         gdouble angle_end);
    +void                clutter_behaviour_rotate_set_axis   (ClutterBehaviourRotate *rotate,
    +                                                         ClutterRotateAxis axis);
    +ClutterRotateAxis   clutter_behaviour_rotate_get_axis   (ClutterBehaviourRotate *rotate);
    +void                clutter_behaviour_rotate_set_direction
    +                                                        (ClutterBehaviourRotate *rotate,
    +                                                         ClutterRotateDirection direction);
    +ClutterRotateDirection  clutter_behaviour_rotate_get_direction
    +                                                        (ClutterBehaviourRotate *rotate);
    +void                clutter_behaviour_rotate_set_bounds (ClutterBehaviourRotate *rotate,
    +                                                         gdouble angle_start,
    +                                                         gdouble angle_end);
    +void                clutter_behaviour_rotate_get_bounds (ClutterBehaviourRotate *rotate,
    +                                                         gdouble *angle_start,
    +                                                         gdouble *angle_end);
    +void                clutter_behaviour_rotate_set_center (ClutterBehaviourRotate *rotate,
    +                                                         gint x,
    +                                                         gint y,
    +                                                         gint z);
    +void                clutter_behaviour_rotate_get_center (ClutterBehaviourRotate *rotate,
    +                                                         gint *x,
    +                                                         gint *y,
    +                                                         gint *z);
     

    Object Hierarchy

    -  GObject
    +  GObject
        +----ClutterBehaviour
              +----ClutterBehaviourRotate
     
    @@ -133,13 +160,23 @@

    Properties

    -  "angle-end"                gdouble               : Read / Write
    -  "angle-start"              gdouble               : Read / Write
    -  "axis"                     ClutterRotateAxis     : Read / Write
    -  "center-x"                 gint                  : Read / Write
    -  "center-y"                 gint                  : Read / Write
    -  "center-z"                 gint                  : Read / Write
    -  "direction"                ClutterRotateDirection  : Read / Write
    +  "angle-end"                gdouble               : Read / Write
    +  "angle-start"              gdouble               : Read / Write
    +  "axis"                     ClutterRotateAxis     : Read / Write
    +  "center-x"                 gint                  : Read / Write
    +  "center-y"                 gint                  : Read / Write
    +  "center-z"                 gint                  : Read / Write
    +  "direction"                ClutterRotateDirection  : Read / Write
     
    @@ -150,6 +187,8 @@

    The ClutterBehaviourRotate is available since version 0.4.

    +

    +

    Details

    @@ -163,21 +202,23 @@

    Axis of a rotation.

    +

    +

    - + - + - + @@ -195,16 +236,18 @@

    Direction of a rotation.

    +

    +

    CLUTTER_X_AXIS

    CLUTTER_X_AXIS

    Rotate around the X axis

    CLUTTER_Y_AXIS

    CLUTTER_Y_AXIS

    Rotate around the Y axis

    CLUTTER_Z_AXIS

    CLUTTER_Z_AXIS

    Rotate around the Z axis
    - + - + @@ -219,6 +262,8 @@

    The ClutterBehaviourRotate struct contains only private data and should be accessed using the provided API

    +

    +

    Since 0.4


    @@ -229,28 +274,36 @@

    The ClutterBehaviourRotateClass struct contains only private data

    +

    +

    Since 0.4


    clutter_behaviour_rotate_new ()

    -
    ClutterBehaviour *  clutter_behaviour_rotate_new        (ClutterAlpha *alpha,
    -                                                         ClutterRotateAxis axis,
    -                                                         ClutterRotateDirection direction,
    -                                                         gdouble angle_start,
    -                                                         gdouble angle_end);
    +
    ClutterBehaviour *  clutter_behaviour_rotate_new        (ClutterAlpha *alpha,
    +                                                         ClutterRotateAxis axis,
    +                                                         ClutterRotateDirection direction,
    +                                                         gdouble angle_start,
    +                                                         gdouble angle_end);

    Creates a new ClutterBehaviourRotate. This behaviour will rotate actors bound to it on axis, following direction, between angle_start and angle_end. Angles >= 360 degrees will be clamped to the canonical interval <0, 360), if angle_start == angle_end, the behaviour will carry out a single rotation of 360 degrees.

    +

    +

    CLUTTER_ROTATE_CW

    CLUTTER_ROTATE_CW

    Clockwise rotation

    CLUTTER_ROTATE_CCW

    CLUTTER_ROTATE_CCW

    Counter-clockwise rotation
    - @@ -286,10 +339,12 @@

    clutter_behaviour_rotate_set_axis ()

    -
    void                clutter_behaviour_rotate_set_axis   (ClutterBehaviourRotate *rotate,
    -                                                         ClutterRotateAxis axis);
    +
    void                clutter_behaviour_rotate_set_axis   (ClutterBehaviourRotate *rotate,
    +                                                         ClutterRotateAxis axis);

    Sets the axis used by the rotate behaviour.

    +

    +

    alpha :

    a ClutterAlpha, or NULL + a ClutterAlpha, or NULL
    @@ -310,9 +365,11 @@

    clutter_behaviour_rotate_get_axis ()

    -
    ClutterRotateAxis   clutter_behaviour_rotate_get_axis   (ClutterBehaviourRotate *rotate);
    +
    ClutterRotateAxis   clutter_behaviour_rotate_get_axis   (ClutterBehaviourRotate *rotate);

    Retrieves the ClutterRotateAxis used by the rotate behaviour.

    +

    +

    @@ -334,11 +391,13 @@

    clutter_behaviour_rotate_set_direction ()

    -
    void                clutter_behaviour_rotate_set_direction
    -                                                        (ClutterBehaviourRotate *rotate,
    -                                                         ClutterRotateDirection direction);
    +
    void                clutter_behaviour_rotate_set_direction
    +                                                        (ClutterBehaviourRotate *rotate,
    +                                                         ClutterRotateDirection direction);

    Sets the rotation direction used by the rotate behaviour.

    +

    +

    @@ -359,10 +418,12 @@

    clutter_behaviour_rotate_get_direction ()

    -
    ClutterRotateDirection  clutter_behaviour_rotate_get_direction
    -                                                        (ClutterBehaviourRotate *rotate);
    +
    ClutterRotateDirection  clutter_behaviour_rotate_get_direction
    +                                                        (ClutterBehaviourRotate *rotate);

    Retrieves the ClutterRotateDirection used by the rotate behaviour.

    +

    +

    @@ -384,12 +445,18 @@

    clutter_behaviour_rotate_set_bounds ()

    -
    void                clutter_behaviour_rotate_set_bounds (ClutterBehaviourRotate *rotate,
    -                                                         gdouble angle_start,
    -                                                         gdouble angle_end);
    +
    void                clutter_behaviour_rotate_set_bounds (ClutterBehaviourRotate *rotate,
    +                                                         gdouble angle_start,
    +                                                         gdouble angle_end);

    Sets the initial and final angles of a rotation behaviour; angles >= 360 degrees get clamped to the canonical interval <0, 360).

    +

    +

    @@ -415,11 +482,17 @@

    clutter_behaviour_rotate_get_bounds ()

    -
    void                clutter_behaviour_rotate_get_bounds (ClutterBehaviourRotate *rotate,
    -                                                         gdouble *angle_start,
    -                                                         gdouble *angle_end);
    +
    void                clutter_behaviour_rotate_get_bounds (ClutterBehaviourRotate *rotate,
    +                                                         gdouble *angle_start,
    +                                                         gdouble *angle_end);

    Retrieves the rotation boundaries of the rotate behaviour.

    +

    +

    @@ -445,13 +518,21 @@

    clutter_behaviour_rotate_set_center ()

    -
    void                clutter_behaviour_rotate_set_center (ClutterBehaviourRotate *rotate,
    -                                                         gint x,
    -                                                         gint y,
    -                                                         gint z);
    +
    void                clutter_behaviour_rotate_set_center (ClutterBehaviourRotate *rotate,
    +                                                         gint x,
    +                                                         gint y,
    +                                                         gint z);

    Sets the center of rotation. The coordinates are relative to the plane normal to the rotation axis set with clutter_behaviour_rotate_set_axis().

    +

    +

    @@ -482,13 +563,21 @@

    clutter_behaviour_rotate_get_center ()

    -
    void                clutter_behaviour_rotate_get_center (ClutterBehaviourRotate *rotate,
    -                                                         gint *x,
    -                                                         gint *y,
    -                                                         gint *z);
    +
    void                clutter_behaviour_rotate_get_center (ClutterBehaviourRotate *rotate,
    +                                                         gint *x,
    +                                                         gint *y,
    +                                                         gint *z);

    Retrieves the center of rotation set using clutter_behaviour_rotate_set_center().

    +

    +

    @@ -521,75 +610,99 @@

    Property Details

    The "angle-end" property

    -
      "angle-end"                gdouble               : Read / Write
    +
      "angle-end"                gdouble               : Read / Write

    The final angle to where the rotation should end.

    +

    +

    Allowed values: [0,360]

    Default value: 0

    -

    Since 0.4

    +

    Since 0.4


    The "angle-start" property

    -
      "angle-start"              gdouble               : Read / Write
    +
      "angle-start"              gdouble               : Read / Write

    The initial angle from whence the rotation should start.

    +

    +

    Allowed values: [0,360]

    Default value: 0

    -

    Since 0.4

    +

    Since 0.4


    The "axis" property

    -
      "axis"                     ClutterRotateAxis     : Read / Write
    +
      "axis"                     ClutterRotateAxis     : Read / Write

    The axis of rotation.

    +

    +

    Default value: CLUTTER_Z_AXIS

    -

    Since 0.4

    +

    Since 0.4


    The "center-x" property

    -
      "center-x"                 gint                  : Read / Write
    +
      "center-x"                 gint                  : Read / Write

    The x center of rotation.

    +

    +

    Allowed values: >= -2147483647

    Default value: 0

    -

    Since 0.4

    +

    Since 0.4


    The "center-y" property

    -
      "center-y"                 gint                  : Read / Write
    +
      "center-y"                 gint                  : Read / Write

    The y center of rotation.

    +

    +

    Allowed values: >= -2147483647

    Default value: 0

    -

    Since 0.4

    +

    Since 0.4


    The "center-z" property

    -
      "center-z"                 gint                  : Read / Write
    +
      "center-z"                 gint                  : Read / Write

    The z center of rotation.

    +

    +

    Allowed values: >= -2147483647

    Default value: 0

    -

    Since 0.4

    +

    Since 0.4


    The "direction" property

    -
      "direction"                ClutterRotateDirection  : Read / Write
    +
      "direction"                ClutterRotateDirection  : Read / Write

    The direction of the rotation.

    +

    +

    Default value: CLUTTER_ROTATE_CW

    -

    Since 0.4

    +

    Since 0.4

    + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ix02.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ix02.html @@ -8,7 +8,7 @@ - + @@ -52,43 +52,49 @@ -
    - + - - - +

    -Index of deprecated symbols

    -

    S

    -
    CLUTTER_STAGE_HEIGHT
    +Index of deprecated symbols
    +
    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/clutter-Win32-Specific-Support.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/clutter-Win32-Specific-Support.html @@ -8,7 +8,7 @@ - + @@ -62,8 +62,8 @@ Top -  |  - Description +  |  + Description
    @@ -77,12 +77,15 @@
    @@ -94,12 +97,14 @@

    The ClutterWin32 API is available since Clutter 0.8

    +

    +

    Details

    clutter_win32_disable_event_retrieval ()

    -
    void                clutter_win32_disable_event_retrieval
    +
    void                clutter_win32_disable_event_retrieval
                                                             (void);

    Disables retrieval of Windows messages in the main loop. Use to @@ -107,15 +112,21 @@

    This function can only be called before calling clutter_init().

    +

    +

    Since 0.8


    clutter_win32_set_stage_foreign ()

    -
    gboolean            clutter_win32_set_stage_foreign     (ClutterStage *stage,
    -                                                         HWND hwnd);
    +
    gboolean            clutter_win32_set_stage_foreign     (ClutterStage *stage,
    +                                                         HWND hwnd);

    Target the ClutterStage to use an existing external window handle.

    +

    +

    @@ -131,7 +142,7 @@ - @@ -142,9 +153,11 @@

    clutter_win32_get_stage_from_window ()

    -
    ClutterStage *      clutter_win32_get_stage_from_window (HWND hwnd);
    +
    ClutterStage *      clutter_win32_get_stage_from_window (HWND hwnd);

    Gets the stage for a particular window.

    +

    +

    Returns :

    TRUE if foreign window is valid + TRUE if foreign window is valid
    @@ -167,9 +180,11 @@

    clutter_win32_get_stage_window ()

    -
    HWND                clutter_win32_get_stage_window      (ClutterStage *stage);
    +
    HWND                clutter_win32_get_stage_window      (ClutterStage *stage);

    Gets the stage's window handle

    +

    +

    @@ -192,6 +207,6 @@ + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ClutterChildMeta.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ClutterChildMeta.html @@ -8,7 +8,7 @@ - + @@ -62,12 +62,12 @@
    Top -  |  - Description -  |  - Object Hierarchy -  |  - Properties +  |  + Description +  |  + Object Hierarchy +  |  + Properties
    @@ -81,16 +81,19 @@

    Object Hierarchy

    -  GObject
    +  GObject
        +----ClutterChildMeta
              +----ClutterLayoutMeta
     
    @@ -98,8 +101,8 @@

    Properties

    -  "actor"                    ClutterActor*         : Read / Write / Construct Only
    -  "container"                ClutterContainer*     : Read / Write / Construct Only
    +  "actor"                    ClutterActor*         : Read / Write / Construct Only
    +  "container"                ClutterContainer*     : Read / Write / Construct Only
     
    @@ -113,6 +116,8 @@

    ClutterChildMeta is available since Clutter 0.8

    +

    +

    Details

    @@ -157,23 +162,29 @@

    The properties of the data and your subclass can be manipulated with clutter_container_child_set() and clutter_container_child_get() which -act like g_object_set() and g_object_get(). +act like g_object_set() and g_object_get().

    You can provide hooks for your own storage as well as control the instantiation by overriding "create_child_meta", "destroy_child_meta" and "get_child_meta".

    +

    +

    - + - + @@ -189,14 +200,18 @@

    The ClutterChildMetaClass contains only private data

    +

    +

    Since 0.8


    clutter_child_meta_get_container ()

    -
    ClutterContainer *  clutter_child_meta_get_container    (ClutterChildMeta *data);
    +
    ClutterContainer *  clutter_child_meta_get_container    (ClutterChildMeta *data);

    Retrieves the container using data

    +

    +

    ClutterContainer *container;

    ClutterContainer *container;

    the container handling this data

    ClutterActor *actor;

    ClutterActor *actor;

    the actor wrapped by this data
    @@ -207,7 +222,7 @@ - +

    Returns :

    a ClutterContainer. transfer none. a ClutterContainer. transfer none.
    @@ -216,9 +231,11 @@

    clutter_child_meta_get_actor ()

    -
    ClutterActor *      clutter_child_meta_get_actor        (ClutterChildMeta *data);
    +
    ClutterActor *      clutter_child_meta_get_actor        (ClutterChildMeta *data);

    Retrieves the actor wrapped by data

    +

    +

    @@ -229,7 +246,7 @@ - +

    Returns :

    a ClutterActor. transfer none. a ClutterActor. transfer none.
    @@ -240,23 +257,27 @@

    Property Details

    The "actor" property

    -
      "actor"                    ClutterActor*         : Read / Write / Construct Only
    +
      "actor"                    ClutterActor*         : Read / Write / Construct Only

    The ClutterActor being wrapped by this ClutterChildMeta

    -

    Since 0.8

    +

    +

    +

    Since 0.8


    The "container" property

    -
      "container"                ClutterContainer*     : Read / Write / Construct Only
    +
      "container"                ClutterContainer*     : Read / Write / Construct Only

    The ClutterContainer that created this ClutterChildMeta.

    -

    Since 0.8

    +

    +

    +

    Since 0.8

    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/clutter-animation-implicit.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/clutter-animation-implicit.html @@ -8,7 +8,7 @@ - + @@ -127,13 +127,15 @@ with the new values.

    If you need to chain up multiple animations created using clutter_actor_animate() you should connect to the - "completed" signal using g_signal_connect_after() + "completed" signal using g_signal_connect_after() to have the guarantee that the current ClutterAnimation has been detached from the actor. The documentation for clutter_actor_animate() has further examples.

    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/license.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/license.html @@ -7,7 +7,7 @@ - + @@ -93,6 +93,6 @@
    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ch05.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ch05.html @@ -8,7 +8,7 @@ - + @@ -61,7 +61,7 @@

    -Base classes

    +Base classes
    ClutterTimeline — A class for time-based events @@ -80,6 +80,6 @@
    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/clutter-Implicit-Animations.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/clutter-Implicit-Animations.html @@ -8,7 +8,7 @@ - + @@ -62,16 +62,16 @@ Top -  |  - Description -  |  - Object Hierarchy -  |  - Implemented Interfaces -  |  - Properties -  |  - Signals +  |  + Description +  |  + Object Hierarchy +  |  + Implemented Interfaces +  |  + Properties +  |  + Signals
    @@ -85,88 +85,163 @@

    Synopsis

    -
                        ClutterAnimation;
    +
    +                    ClutterAnimation;
                         ClutterAnimationClass;
     enum                ClutterAnimationMode;
    -ClutterAnimation *  clutter_animation_new               (void);
    -void                clutter_animation_set_object        (ClutterAnimation *animation,
    -                                                         GObject *object);
    -GObject *           clutter_animation_get_object        (ClutterAnimation *animation);
    -void                clutter_animation_set_mode          (ClutterAnimation *animation,
    -                                                         gulong mode);
    -gulong              clutter_animation_get_mode          (ClutterAnimation *animation);
    -void                clutter_animation_set_duration      (ClutterAnimation *animation,
    -                                                         gint msecs);
    -guint               clutter_animation_get_duration      (ClutterAnimation *animation);
    -void                clutter_animation_set_loop          (ClutterAnimation *animation,
    -                                                         gboolean loop);
    -gboolean            clutter_animation_get_loop          (ClutterAnimation *animation);
    -void                clutter_animation_set_timeline      (ClutterAnimation *animation,
    -                                                         ClutterTimeline *timeline);
    -ClutterTimeline *   clutter_animation_get_timeline      (ClutterAnimation *animation);
    -void                clutter_animation_set_alpha         (ClutterAnimation *animation,
    -                                                         ClutterAlpha *alpha);
    -ClutterAlpha *      clutter_animation_get_alpha         (ClutterAnimation *animation);
    -void                clutter_animation_completed         (ClutterAnimation *animation);
    -
    -ClutterAnimation *  clutter_animation_bind              (ClutterAnimation *animation,
    -                                                         const gchar *property_name,
    -                                                         const GValue *final);
    -ClutterAnimation *  clutter_animation_bind_interval     (ClutterAnimation *animation,
    -                                                         const gchar *property_name,
    -                                                         ClutterInterval *interval);
    -ClutterAnimation *  clutter_animation_update            (ClutterAnimation *animation,
    -                                                         const gchar *property_name,
    -                                                         const GValue *final);
    -void                clutter_animation_update_interval   (ClutterAnimation *animation,
    -                                                         const gchar *property_name,
    -                                                         ClutterInterval *interval);
    -gboolean            clutter_animation_has_property      (ClutterAnimation *animation,
    -                                                         const gchar *property_name);
    -void                clutter_animation_unbind_property   (ClutterAnimation *animation,
    -                                                         const gchar *property_name);
    -ClutterInterval *   clutter_animation_get_interval      (ClutterAnimation *animation,
    -                                                         const gchar *property_name);
    -
    -ClutterAnimation *  clutter_actor_animate               (ClutterActor *actor,
    -                                                         gulong mode,
    -                                                         guint duration,
    -                                                         const gchar *first_property_name,
    +ClutterAnimation *  clutter_animation_new               (void);
    +void                clutter_animation_set_object        (ClutterAnimation *animation,
    +                                                         GObject *object);
    +GObject *           clutter_animation_get_object        (ClutterAnimation *animation);
    +void                clutter_animation_set_mode          (ClutterAnimation *animation,
    +                                                         gulong mode);
    +gulong              clutter_animation_get_mode          (ClutterAnimation *animation);
    +void                clutter_animation_set_duration      (ClutterAnimation *animation,
    +                                                         gint msecs);
    +guint               clutter_animation_get_duration      (ClutterAnimation *animation);
    +void                clutter_animation_set_loop          (ClutterAnimation *animation,
    +                                                         gboolean loop);
    +gboolean            clutter_animation_get_loop          (ClutterAnimation *animation);
    +void                clutter_animation_set_timeline      (ClutterAnimation *animation,
    +                                                         ClutterTimeline *timeline);
    +ClutterTimeline *   clutter_animation_get_timeline      (ClutterAnimation *animation);
    +void                clutter_animation_set_alpha         (ClutterAnimation *animation,
    +                                                         ClutterAlpha *alpha);
    +ClutterAlpha *      clutter_animation_get_alpha         (ClutterAnimation *animation);
    +void                clutter_animation_completed         (ClutterAnimation *animation);
    +
    +ClutterAnimation *  clutter_animation_bind              (ClutterAnimation *animation,
    +                                                         const gchar *property_name,
    +                                                         const GValue *final);
    +ClutterAnimation *  clutter_animation_bind_interval     (ClutterAnimation *animation,
    +                                                         const gchar *property_name,
    +                                                         ClutterInterval *interval);
    +ClutterAnimation *  clutter_animation_update            (ClutterAnimation *animation,
    +                                                         const gchar *property_name,
    +                                                         const GValue *final);
    +void                clutter_animation_update_interval   (ClutterAnimation *animation,
    +                                                         const gchar *property_name,
    +                                                         ClutterInterval *interval);
    +gboolean            clutter_animation_has_property      (ClutterAnimation *animation,
    +                                                         const gchar *property_name);
    +void                clutter_animation_unbind_property   (ClutterAnimation *animation,
    +                                                         const gchar *property_name);
    +ClutterInterval *   clutter_animation_get_interval      (ClutterAnimation *animation,
    +                                                         const gchar *property_name);
    +
    +ClutterAnimation *  clutter_actor_animate               (ClutterActor *actor,
    +                                                         gulong mode,
    +                                                         guint duration,
    +                                                         const gchar *first_property_name,
                                                              ...);
    -ClutterAnimation *  clutter_actor_animate_with_timeline (ClutterActor *actor,
    -                                                         gulong mode,
    -                                                         ClutterTimeline *timeline,
    -                                                         const gchar *first_property_name,
    +ClutterAnimation *  clutter_actor_animate_with_timeline (ClutterActor *actor,
    +                                                         gulong mode,
    +                                                         ClutterTimeline *timeline,
    +                                                         const gchar *first_property_name,
                                                              ...);
    -ClutterAnimation *  clutter_actor_animate_with_alpha    (ClutterActor *actor,
    -                                                         ClutterAlpha *alpha,
    -                                                         const gchar *first_property_name,
    +ClutterAnimation *  clutter_actor_animate_with_alpha    (ClutterActor *actor,
    +                                                         ClutterAlpha *alpha,
    +                                                         const gchar *first_property_name,
                                                              ...);
    -ClutterAnimation *  clutter_actor_animatev              (ClutterActor *actor,
    -                                                         gulong mode,
    -                                                         guint duration,
    -                                                         gint n_properties,
    -                                                         const gchar * const properties[],
    -                                                         const GValue *values);
    -ClutterAnimation *  clutter_actor_animate_with_timelinev
    -                                                        (ClutterActor *actor,
    -                                                         gulong mode,
    -                                                         ClutterTimeline *timeline,
    -                                                         gint n_properties,
    -                                                         const gchar * const properties[],
    -                                                         const GValue *values);
    -ClutterAnimation *  clutter_actor_animate_with_alphav   (ClutterActor *actor,
    -                                                         ClutterAlpha *alpha,
    -                                                         gint n_properties,
    -                                                         const gchar * const properties[],
    -                                                         const GValue *values);
    -ClutterAnimation *  clutter_actor_get_animation         (ClutterActor *actor);
    +ClutterAnimation *  clutter_actor_animatev              (ClutterActor *actor,
    +                                                         gulong mode,
    +                                                         guint duration,
    +                                                         gint n_properties,
    +                                                         const gchar * const properties[],
    +                                                         const GValue *values);
    +ClutterAnimation *  clutter_actor_animate_with_timelinev
    +                                                        (ClutterActor *actor,
    +                                                         gulong mode,
    +                                                         ClutterTimeline *timeline,
    +                                                         gint n_properties,
    +                                                         const gchar * const properties[],
    +                                                         const GValue *values);
    +ClutterAnimation *  clutter_actor_animate_with_alphav   (ClutterActor *actor,
    +                                                         ClutterAlpha *alpha,
    +                                                         gint n_properties,
    +                                                         const gchar * const properties[],
    +                                                         const GValue *values);
    +ClutterAnimation *  clutter_actor_get_animation         (ClutterActor *actor);
     

    Object Hierarchy

    -  GObject
    +  GObject
        +----ClutterAnimation
     
    @@ -179,12 +254,20 @@

    Properties

    -  "alpha"                    ClutterAlpha*         : Read / Write
    -  "duration"                 guint                 : Read / Write
    -  "loop"                     gboolean              : Read / Write
    -  "mode"                     gulong                : Read / Write
    -  "object"                   GObject*              : Read / Write
    -  "timeline"                 ClutterTimeline*      : Read / Write
    +  "alpha"                    ClutterAlpha*         : Read / Write
    +  "duration"                 guint                 : Read / Write
    +  "loop"                     gboolean              : Read / Write
    +  "mode"                     gulong                : Read / Write
    +  "object"                   GObject*              : Read / Write
    +  "timeline"                 ClutterTimeline*      : Read / Write
     
    @@ -198,11 +281,17 @@

    Description

    ClutterAnimation is an object providing simple, implicit animations -for GObjects. +for GObjects.

    -ClutterAnimation instances will bind one or more GObject properties -belonging to a GObject to a ClutterInterval, and will then use a +ClutterAnimation instances will bind one or more GObject properties +belonging to a GObject to a ClutterInterval, and will then use a ClutterAlpha to interpolate the property between the initial and final values of the interval.

    @@ -220,7 +309,7 @@ A ClutterAnimation will emit the "completed" signal when the ClutterTimeline used by the animation is completed; unlike ClutterTimeline, though, the "completed" will not be -emitted if "loop" is set to TRUE - that is, a looping +emitted if "loop" is set to TRUE - that is, a looping animation never completes.

    @@ -228,14 +317,20 @@ using clutter_animation_completed().

    -If the GObject instance bound to a ClutterAnimation implements the +If the GObject instance bound to a ClutterAnimation implements the ClutterAnimatable interface it is possible for that instance to control the way the initial and final states are interpolated.

    ClutterAnimations are distinguished from ClutterBehaviours -because the former can only control GObject properties of a single -GObject instance, while the latter can control multiple properties +because the former can only control GObject properties of a single +GObject instance, while the latter can control multiple properties using accessor functions inside the "alpha_notify" virtual function, and can control multiple ClutterActors as well.

    @@ -252,7 +347,9 @@

    When defining a ClutterAnimation inside a ClutterScript file or string the "mode" can be defined either using the ClutterAnimationMode enumeration values through their - "nick" (the short string used inside GEnumValue), their numeric + "nick" (the short string used inside GEnumValue), their numeric id, or using the following strings:

    @@ -314,6 +411,8 @@

    ClutterAnimation is available since Clutter 1.0

    +

    +

    Details

    @@ -323,6 +422,8 @@

    The ClutterAnimation structure contains only private data and should be accessed using the provided functions.

    +

    +

    Since 1.0


    @@ -336,16 +437,18 @@

    The ClutterAnimationClass structure contains only private data and should be accessed using the provided functions.

    +

    +

    - + - + @@ -424,192 +527,194 @@

    Every global alpha function registered using clutter_alpha_register_func() or clutter_alpha_register_closure() will have a logical id greater than -CLUTTER_ANIMATION_LAST.

    +CLUTTER_ANIMATION_LAST.

    +

    +

    started ()

    started ()

    class handler for the "started" signal

    completed ()

    completed ()

    class handler for the "completed" signal
    - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + @@ -621,10 +726,12 @@

    clutter_animation_new ()

    -
    ClutterAnimation *  clutter_animation_new               (void);
    +
    ClutterAnimation *  clutter_animation_new               (void);

    Creates a new ClutterAnimation instance. You should set the -GObject to be animated using clutter_animation_set_object(), +GObject to be animated using clutter_animation_set_object(), set the duration with clutter_animation_set_duration() and the easing mode using clutter_animation_set_mode().

    @@ -638,11 +745,15 @@ 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.

    +

    +

    CLUTTER_CUSTOM_MODE

    CLUTTER_CUSTOM_MODE

    custom progress function

    CLUTTER_LINEAR

    CLUTTER_LINEAR

    linear tweening

    CLUTTER_EASE_IN_QUAD

    CLUTTER_EASE_IN_QUAD

    quadratic tweening

    CLUTTER_EASE_OUT_QUAD

    CLUTTER_EASE_OUT_QUAD

    quadratic tweening, inverse of - CLUTTER_EASE_IN_QUAD + CLUTTER_EASE_IN_QUAD

    CLUTTER_EASE_IN_OUT_QUAD

    CLUTTER_EASE_IN_OUT_QUAD

    quadratic tweening, combininig - CLUTTER_EASE_IN_QUAD and CLUTTER_EASE_OUT_QUAD + CLUTTER_EASE_IN_QUAD and CLUTTER_EASE_OUT_QUAD

    CLUTTER_EASE_IN_CUBIC

    CLUTTER_EASE_IN_CUBIC

    cubic tweening

    CLUTTER_EASE_OUT_CUBIC

    CLUTTER_EASE_OUT_CUBIC

    cubic tweening, invers of - CLUTTER_EASE_IN_CUBIC + CLUTTER_EASE_IN_CUBIC

    CLUTTER_EASE_IN_OUT_CUBIC

    CLUTTER_EASE_IN_OUT_CUBIC

    cubic tweening, combining - CLUTTER_EASE_IN_CUBIC and CLUTTER_EASE_OUT_CUBIC + CLUTTER_EASE_IN_CUBIC and CLUTTER_EASE_OUT_CUBIC

    CLUTTER_EASE_IN_QUART

    CLUTTER_EASE_IN_QUART

    quartic tweening

    CLUTTER_EASE_OUT_QUART

    CLUTTER_EASE_OUT_QUART

    quartic tweening, inverse of - CLUTTER_EASE_IN_QUART + CLUTTER_EASE_IN_QUART

    CLUTTER_EASE_IN_OUT_QUART

    CLUTTER_EASE_IN_OUT_QUART

    quartic tweening, combining - CLUTTER_EASE_IN_QUART and CLUTTER_EASE_OUT_QUART + CLUTTER_EASE_IN_QUART and CLUTTER_EASE_OUT_QUART

    CLUTTER_EASE_IN_QUINT

    CLUTTER_EASE_IN_QUINT

    quintic tweening

    CLUTTER_EASE_OUT_QUINT

    CLUTTER_EASE_OUT_QUINT

    quintic tweening, inverse of - CLUTTER_EASE_IN_QUINT + CLUTTER_EASE_IN_QUINT

    CLUTTER_EASE_IN_OUT_QUINT

    CLUTTER_EASE_IN_OUT_QUINT

    fifth power tweening, combining - CLUTTER_EASE_IN_QUINT and CLUTTER_EASE_OUT_QUINT + CLUTTER_EASE_IN_QUINT and CLUTTER_EASE_OUT_QUINT

    CLUTTER_EASE_IN_SINE

    CLUTTER_EASE_IN_SINE

    sinusoidal tweening

    CLUTTER_EASE_OUT_SINE

    CLUTTER_EASE_OUT_SINE

    sinusoidal tweening, inverse of - CLUTTER_EASE_IN_SINE + CLUTTER_EASE_IN_SINE

    CLUTTER_EASE_IN_OUT_SINE

    CLUTTER_EASE_IN_OUT_SINE

    sine wave tweening, combining - CLUTTER_EASE_IN_SINE and CLUTTER_EASE_OUT_SINE + CLUTTER_EASE_IN_SINE and CLUTTER_EASE_OUT_SINE

    CLUTTER_EASE_IN_EXPO

    CLUTTER_EASE_IN_EXPO

    exponential tweening

    CLUTTER_EASE_OUT_EXPO

    CLUTTER_EASE_OUT_EXPO

    exponential tweening, inverse of - CLUTTER_EASE_IN_EXPO + CLUTTER_EASE_IN_EXPO

    CLUTTER_EASE_IN_OUT_EXPO

    CLUTTER_EASE_IN_OUT_EXPO

    exponential tweening, combining - CLUTTER_EASE_IN_EXPO and CLUTTER_EASE_OUT_EXPO + CLUTTER_EASE_IN_EXPO and CLUTTER_EASE_OUT_EXPO

    CLUTTER_EASE_IN_CIRC

    CLUTTER_EASE_IN_CIRC

    circular tweening

    CLUTTER_EASE_OUT_CIRC

    CLUTTER_EASE_OUT_CIRC

    circular tweening, inverse of - CLUTTER_EASE_IN_CIRC + CLUTTER_EASE_IN_CIRC

    CLUTTER_EASE_IN_OUT_CIRC

    CLUTTER_EASE_IN_OUT_CIRC

    circular tweening, combining - CLUTTER_EASE_IN_CIRC and CLUTTER_EASE_OUT_CIRC + CLUTTER_EASE_IN_CIRC and CLUTTER_EASE_OUT_CIRC

    CLUTTER_EASE_IN_ELASTIC

    CLUTTER_EASE_IN_ELASTIC

    elastic tweening, with offshoot on start

    CLUTTER_EASE_OUT_ELASTIC

    CLUTTER_EASE_OUT_ELASTIC

    elastic tweening, with offshoot on end

    CLUTTER_EASE_IN_OUT_ELASTIC

    CLUTTER_EASE_IN_OUT_ELASTIC

    elastic tweening with offshoot on both ends

    CLUTTER_EASE_IN_BACK

    CLUTTER_EASE_IN_BACK

    overshooting cubic tweening, with backtracking on start

    CLUTTER_EASE_OUT_BACK

    CLUTTER_EASE_OUT_BACK

    overshooting cubic tweening, with backtracking on end

    CLUTTER_EASE_IN_OUT_BACK

    CLUTTER_EASE_IN_OUT_BACK

    overshooting cubic tweening, with backtracking on both ends

    CLUTTER_EASE_IN_BOUNCE

    CLUTTER_EASE_IN_BOUNCE

    exponentially decaying parabolic (bounce) tweening, with bounce on start

    CLUTTER_EASE_OUT_BOUNCE

    CLUTTER_EASE_OUT_BOUNCE

    exponentially decaying parabolic (bounce) tweening, with bounce on end

    CLUTTER_EASE_IN_OUT_BOUNCE

    CLUTTER_EASE_IN_OUT_BOUNCE

    exponentially decaying parabolic (bounce) tweening, with bounce on both ends

    CLUTTER_ANIMATION_LAST

    CLUTTER_ANIMATION_LAST

    last animation mode, used as a guard for registered global alpha functions
    - @@ -653,11 +764,15 @@

    clutter_animation_set_object ()

    -
    void                clutter_animation_set_object        (ClutterAnimation *animation,
    -                                                         GObject *object);
    +
    void                clutter_animation_set_object        (ClutterAnimation *animation,
    +                                                         GObject *object);

    Attaches animation to object. The ClutterAnimation will take a reference on object.

    +

    +

    Returns :

    the newly created ClutterAnimation. Use g_object_unref() + the newly created ClutterAnimation. Use g_object_unref() to release the associated resources
    @@ -668,7 +783,9 @@ - @@ -678,9 +795,15 @@

    clutter_animation_get_object ()

    -
    GObject *           clutter_animation_get_object        (ClutterAnimation *animation);
    +
    GObject *           clutter_animation_get_object        (ClutterAnimation *animation);
    +

    +Retrieves the GObject attached to animation.

    -Retrieves the GObject attached to animation.

    +

    object :

    a GObject + a GObject
    @@ -691,7 +814,9 @@ - +

    Returns :

    a GObject. transfer none. a GObject. transfer none.
    @@ -700,8 +825,10 @@

    clutter_animation_set_mode ()

    -
    void                clutter_animation_set_mode          (ClutterAnimation *animation,
    -                                                         gulong mode);
    +
    void                clutter_animation_set_mode          (ClutterAnimation *animation,
    +                                                         gulong mode);

    Sets the animation mode of animation. The animation mode is a logical id, either coming from the ClutterAnimationMode enumeration @@ -709,6 +836,8 @@

    This function will also set "alpha" if needed.

    +

    +

    @@ -729,10 +858,14 @@

    clutter_animation_get_mode ()

    -
    gulong              clutter_animation_get_mode          (ClutterAnimation *animation);
    +
    gulong              clutter_animation_get_mode          (ClutterAnimation *animation);

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

    +

    +

    @@ -754,14 +887,18 @@

    clutter_animation_set_duration ()

    -
    void                clutter_animation_set_duration      (ClutterAnimation *animation,
    -                                                         gint msecs);
    +
    void                clutter_animation_set_duration      (ClutterAnimation *animation,
    +                                                         gint msecs);

    Sets the duration of animation in milliseconds.

    This function will set "alpha" and "timeline" if needed.

    +

    +

    @@ -782,9 +919,13 @@

    clutter_animation_get_duration ()

    -
    guint               clutter_animation_get_duration      (ClutterAnimation *animation);
    +
    guint               clutter_animation_get_duration      (ClutterAnimation *animation);

    Retrieves the duration of animation, in milliseconds.

    +

    +

    @@ -806,8 +947,10 @@

    clutter_animation_set_loop ()

    -
    void                clutter_animation_set_loop          (ClutterAnimation *animation,
    -                                                         gboolean loop);
    +
    void                clutter_animation_set_loop          (ClutterAnimation *animation,
    +                                                         gboolean loop);

    Sets whether animation should loop over itself once finished.

    @@ -818,6 +961,8 @@

    This function will set "alpha" and "timeline" if needed.

    +

    +

    @@ -828,7 +973,7 @@ - @@ -838,9 +983,13 @@

    clutter_animation_get_loop ()

    -
    gboolean            clutter_animation_get_loop          (ClutterAnimation *animation);
    +
    gboolean            clutter_animation_get_loop          (ClutterAnimation *animation);

    Retrieves whether animation is looping.

    +

    +

    loop :

    TRUE if the animation should loop + TRUE if the animation should loop
    @@ -851,7 +1000,7 @@ - @@ -862,10 +1011,12 @@

    clutter_animation_set_timeline ()

    -
    void                clutter_animation_set_timeline      (ClutterAnimation *animation,
    -                                                         ClutterTimeline *timeline);
    +
    void                clutter_animation_set_timeline      (ClutterAnimation *animation,
    +                                                         ClutterTimeline *timeline);

    Sets the ClutterTimeline used by animation.

    +

    +

    Returns :

    TRUE if the animation is looping + TRUE if the animation is looping
    @@ -876,7 +1027,7 @@ - @@ -887,9 +1038,11 @@

    clutter_animation_get_timeline ()

    -
    ClutterTimeline *   clutter_animation_get_timeline      (ClutterAnimation *animation);
    +
    ClutterTimeline *   clutter_animation_get_timeline      (ClutterAnimation *animation);

    Retrieves the ClutterTimeline used by animation

    +

    +

    timeline :

    a ClutterTimeline, or NULL to unset the + a ClutterTimeline, or NULL to unset the current ClutterTimeline
    @@ -900,7 +1053,7 @@ - +

    Returns :

    the timeline used by the animation. transfer none. the timeline used by the animation. transfer none.
    @@ -909,14 +1062,16 @@

    clutter_animation_set_alpha ()

    -
    void                clutter_animation_set_alpha         (ClutterAnimation *animation,
    -                                                         ClutterAlpha *alpha);
    +
    void                clutter_animation_set_alpha         (ClutterAnimation *animation,
    +                                                         ClutterAlpha *alpha);

    Sets alpha as the ClutterAlpha used by animation.

    -If alpha is not NULL, the ClutterAnimation will take ownership +If alpha is not NULL, the ClutterAnimation will take ownership of the ClutterAlpha instance.

    +

    +

    @@ -927,7 +1082,7 @@ - @@ -937,9 +1092,11 @@

    clutter_animation_get_alpha ()

    -
    ClutterAlpha *      clutter_animation_get_alpha         (ClutterAnimation *animation);
    +
    ClutterAlpha *      clutter_animation_get_alpha         (ClutterAnimation *animation);

    Retrieves the ClutterAlpha used by animation.

    +

    +

    alpha :

    a ClutterAlpha, or NULL to unset the current ClutterAlpha + a ClutterAlpha, or NULL to unset the current ClutterAlpha
    @@ -950,7 +1107,7 @@ - +

    Returns :

    the alpha object used by the animation. transfer none. the alpha object used by the animation. transfer none.
    @@ -959,7 +1116,7 @@

    clutter_animation_completed ()

    -
    void                clutter_animation_completed         (ClutterAnimation *animation);
    +
    void                clutter_animation_completed         (ClutterAnimation *animation);

    Emits the ::completed signal on animation

    @@ -967,9 +1124,13 @@ When using this function with a ClutterAnimation created by the clutter_actor_animate() family of functions, animation will be unreferenced and it will not be valid anymore, -unless g_object_ref() was called before calling this function +unless g_object_ref() was called before calling this function or unless a reference was taken inside a handler for the "completed" signal

    +

    +

    @@ -983,9 +1144,13 @@

    clutter_animation_bind ()

    -
    ClutterAnimation *  clutter_animation_bind              (ClutterAnimation *animation,
    -                                                         const gchar *property_name,
    -                                                         const GValue *final);
    +
    ClutterAnimation *  clutter_animation_bind              (ClutterAnimation *animation,
    +                                                         const gchar *property_name,
    +                                                         const GValue *final);

    Adds a single property with name property_name to the animation animation. For more information about animations, @@ -994,6 +1159,8 @@

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

    +

    +

    @@ -1014,7 +1181,7 @@ - +

    Returns :

    The animation itself.. transfer none. The animation itself.. transfer none.
    @@ -1023,11 +1190,15 @@

    clutter_animation_bind_interval ()

    -
    ClutterAnimation *  clutter_animation_bind_interval     (ClutterAnimation *animation,
    -                                                         const gchar *property_name,
    -                                                         ClutterInterval *interval);
    -

    -Binds interval to the property_name of the GObject +

    ClutterAnimation *  clutter_animation_bind_interval     (ClutterAnimation *animation,
    +                                                         const gchar *property_name,
    +                                                         ClutterInterval *interval);
    +

    +Binds interval to the property_name of the GObject attached to animation. The ClutterAnimation will take ownership of the passed ClutterInterval. For more information about animations, see clutter_actor_animate(). @@ -1035,6 +1206,8 @@

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

    +

    +

    @@ -1050,11 +1223,11 @@ - + - +

    interval :

    a ClutterInterval. transfer full. a ClutterInterval. transfer full.

    Returns :

    The animation itself.. transfer none. The animation itself.. transfer none.
    @@ -1063,11 +1236,17 @@

    clutter_animation_update ()

    -
    ClutterAnimation *  clutter_animation_update            (ClutterAnimation *animation,
    -                                                         const gchar *property_name,
    -                                                         const GValue *final);
    +
    ClutterAnimation *  clutter_animation_update            (ClutterAnimation *animation,
    +                                                         const gchar *property_name,
    +                                                         const GValue *final);

    Updates the final value of the interval for property_name

    +

    +

    @@ -1088,7 +1267,7 @@ - +

    Returns :

    The animation itself.. transfer none. The animation itself.. transfer none.
    @@ -1097,12 +1276,16 @@

    clutter_animation_update_interval ()

    -
    void                clutter_animation_update_interval   (ClutterAnimation *animation,
    -                                                         const gchar *property_name,
    -                                                         ClutterInterval *interval);
    +
    void                clutter_animation_update_interval   (ClutterAnimation *animation,
    +                                                         const gchar *property_name,
    +                                                         ClutterInterval *interval);

    Changes the interval for property_name. The ClutterAnimation will take ownership of the passed ClutterInterval.

    +

    +

    @@ -1128,10 +1311,16 @@

    clutter_animation_has_property ()

    -
    gboolean            clutter_animation_has_property      (ClutterAnimation *animation,
    -                                                         const gchar *property_name);
    +
    gboolean            clutter_animation_has_property      (ClutterAnimation *animation,
    +                                                         const gchar *property_name);

    Checks whether animation is controlling property_name.

    +

    +

    @@ -1147,8 +1336,8 @@ - @@ -1159,10 +1348,14 @@

    clutter_animation_unbind_property ()

    -
    void                clutter_animation_unbind_property   (ClutterAnimation *animation,
    -                                                         const gchar *property_name);
    +
    void                clutter_animation_unbind_property   (ClutterAnimation *animation,
    +                                                         const gchar *property_name);

    Removes property_name from the list of animated properties.

    +

    +

    Returns :

    TRUE if the property is animated by the - ClutterAnimation, FALSE otherwise + TRUE if the property is animated by the + ClutterAnimation, FALSE otherwise
    @@ -1183,11 +1376,15 @@

    clutter_animation_get_interval ()

    -
    ClutterInterval *   clutter_animation_get_interval      (ClutterAnimation *animation,
    -                                                         const gchar *property_name);
    +
    ClutterInterval *   clutter_animation_get_interval      (ClutterAnimation *animation,
    +                                                         const gchar *property_name);

    Retrieves the ClutterInterval associated to property_name inside animation.

    +

    +

    @@ -1203,7 +1400,7 @@ - +

    Returns :

    transfer none. transfer none. transfer none. transfer none.
    @@ -1212,10 +1409,16 @@

    clutter_actor_animate ()

    -
    ClutterAnimation *  clutter_actor_animate               (ClutterActor *actor,
    -                                                         gulong mode,
    -                                                         guint duration,
    -                                                         const gchar *first_property_name,
    +
    ClutterAnimation *  clutter_actor_animate               (ClutterActor *actor,
    +                                                         gulong mode,
    +                                                         guint duration,
    +                                                         const gchar *first_property_name,
                                                              ...);

    Animates the given list of properties of actor between the current @@ -1310,14 +1513,26 @@

    -The "signal::" modifier is the equivalent of using g_signal_connect(); +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() +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. @@ -1371,7 +1586,9 @@ signal emission chain, you will not be able to create a new animation using clutter_actor_animate() on the same actor from within the "completed" signal handler unless you use -g_signal_connect_after() to connect the callback function, for instance: +g_signal_connect_after() to connect the callback function, for instance:

    @@ -1396,6 +1613,8 @@ actor); ...
    +

    +

    @@ -1421,13 +1640,13 @@ - - +

    ... :

    a NULL terminated list of property names and + a NULL terminated list of property names and property values

    Returns :

    transfer none. transfer none. transfer none. transfer none.
    @@ -1436,10 +1655,14 @@

    clutter_actor_animate_with_timeline ()

    -
    ClutterAnimation *  clutter_actor_animate_with_timeline (ClutterActor *actor,
    -                                                         gulong mode,
    -                                                         ClutterTimeline *timeline,
    -                                                         const gchar *first_property_name,
    +
    ClutterAnimation *  clutter_actor_animate_with_timeline (ClutterActor *actor,
    +                                                         gulong mode,
    +                                                         ClutterTimeline *timeline,
    +                                                         const gchar *first_property_name,
                                                              ...);

    Animates the given list of properties of actor between the current @@ -1452,6 +1675,8 @@

    This function is useful if you want to use an existing timeline to animate actor.

    +

    +

    @@ -1477,13 +1702,13 @@ - - +

    ... :

    a NULL terminated list of property names and + a NULL terminated list of property names and property values

    Returns :

    transfer none. transfer none. transfer none. transfer none.
    @@ -1492,9 +1717,11 @@

    clutter_actor_animate_with_alpha ()

    -
    ClutterAnimation *  clutter_actor_animate_with_alpha    (ClutterActor *actor,
    -                                                         ClutterAlpha *alpha,
    -                                                         const gchar *first_property_name,
    +
    ClutterAnimation *  clutter_actor_animate_with_alpha    (ClutterActor *actor,
    +                                                         ClutterAlpha *alpha,
    +                                                         const gchar *first_property_name,
                                                              ...);

    Animates the given list of properties of actor between the current @@ -1507,6 +1734,8 @@

    This function is useful if you want to use an existing ClutterAlpha to animate actor.

    +

    +

    @@ -1527,13 +1756,13 @@ - - +

    ... :

    a NULL terminated list of property names and + a NULL terminated list of property names and property values

    Returns :

    transfer none. transfer none. transfer none. transfer none.
    @@ -1542,12 +1771,22 @@

    clutter_actor_animatev ()

    -
    ClutterAnimation *  clutter_actor_animatev              (ClutterActor *actor,
    -                                                         gulong mode,
    -                                                         guint duration,
    -                                                         gint n_properties,
    -                                                         const gchar * const properties[],
    -                                                         const GValue *values);
    +
    ClutterAnimation *  clutter_actor_animatev              (ClutterActor *actor,
    +                                                         gulong mode,
    +                                                         guint duration,
    +                                                         gint n_properties,
    +                                                         const gchar * const properties[],
    +                                                         const GValue *values);

    Animates the given list of properties of actor between the current value for each property and a new final value. The animation has a @@ -1562,6 +1801,8 @@

    Warning

    Unlike clutter_actor_animate(), this function will not allow you to specify "signal::" names and callbacks.
    +

    +

    @@ -1595,7 +1836,7 @@ - +

    Returns :

    transfer none. transfer none. transfer none. transfer none.
    @@ -1604,13 +1845,21 @@

    clutter_actor_animate_with_timelinev ()

    -
    ClutterAnimation *  clutter_actor_animate_with_timelinev
    -                                                        (ClutterActor *actor,
    -                                                         gulong mode,
    -                                                         ClutterTimeline *timeline,
    -                                                         gint n_properties,
    -                                                         const gchar * const properties[],
    -                                                         const GValue *values);
    +
    ClutterAnimation *  clutter_actor_animate_with_timelinev
    +                                                        (ClutterActor *actor,
    +                                                         gulong mode,
    +                                                         ClutterTimeline *timeline,
    +                                                         gint n_properties,
    +                                                         const gchar * const properties[],
    +                                                         const GValue *values);

    Animates the given list of properties of actor between the current value for each property and a new final value. The animation has a @@ -1632,6 +1881,8 @@

    Warning

    Unlike clutter_actor_animate_with_timeline(), this function will not allow you to specify "signal::" names and callbacks.
    +

    +

    @@ -1665,7 +1916,7 @@ - +

    Returns :

    transfer none. transfer none. transfer none. transfer none.
    @@ -1674,11 +1925,17 @@

    clutter_actor_animate_with_alphav ()

    -
    ClutterAnimation *  clutter_actor_animate_with_alphav   (ClutterActor *actor,
    -                                                         ClutterAlpha *alpha,
    -                                                         gint n_properties,
    -                                                         const gchar * const properties[],
    -                                                         const GValue *values);
    +
    ClutterAnimation *  clutter_actor_animate_with_alphav   (ClutterActor *actor,
    +                                                         ClutterAlpha *alpha,
    +                                                         gint n_properties,
    +                                                         const gchar * const properties[],
    +                                                         const GValue *values);

    Animates the given list of properties of actor between the current value for each property and a new final value. The animation has a @@ -1700,6 +1957,8 @@

    Warning

    Unlike clutter_actor_animate_with_alpha(), this function will not allow you to specify "signal::" names and callbacks.
    +

    +

    @@ -1728,7 +1987,7 @@ - +

    Returns :

    transfer none. transfer none. transfer none. transfer none.
    @@ -1737,10 +1996,12 @@

    clutter_actor_get_animation ()

    -
    ClutterAnimation *  clutter_actor_get_animation         (ClutterActor *actor);
    +
    ClutterAnimation *  clutter_actor_get_animation         (ClutterActor *actor);

    Retrieves the ClutterAnimation used by actor, if clutter_actor_animate() has been called on actor.

    +

    +

    @@ -1751,7 +2012,7 @@ - +

    Returns :

    a ClutterAnimation, or NULL. transfer none. a ClutterAnimation, or NULL. transfer none.
    @@ -1762,62 +2023,86 @@

    Property Details

    The "alpha" property

    -
      "alpha"                    ClutterAlpha*         : Read / Write
    +
      "alpha"                    ClutterAlpha*         : Read / Write

    The ClutterAlpha used by the animation.

    -

    Since 1.0

    +

    +

    +

    Since 1.0


    The "duration" property

    -
      "duration"                 guint                 : Read / Write
    +
      "duration"                 guint                 : Read / Write

    The duration of the animation, expressed in milliseconds.

    +

    +

    Default value: 0

    -

    Since 1.0

    +

    Since 1.0


    The "loop" property

    -
      "loop"                     gboolean              : Read / Write
    +
      "loop"                     gboolean              : Read / Write

    Whether the animation should loop.

    +

    +

    Default value: FALSE

    -

    Since 1.0

    +

    Since 1.0


    The "mode" property

    -
      "mode"                     gulong                : Read / Write
    +
      "mode"                     gulong                : Read / Write

    The animation mode, either a value from ClutterAnimationMode or a value returned by clutter_alpha_register_func(). The -default value is CLUTTER_LINEAR.

    -

    Since 1.0

    +default value is CLUTTER_LINEAR.

    +

    +

    +

    Since 1.0


    The "object" property

    -
      "object"                   GObject*              : Read / Write
    +
      "object"                   GObject*              : Read / Write

    -The GObject to which the animation applies.

    -

    Since 1.0

    +The GObject to which the animation applies.

    +

    +

    +

    Since 1.0


    The "timeline" property

    -
      "timeline"                 ClutterTimeline*      : Read / Write
    +
      "timeline"                 ClutterTimeline*      : Read / Write

    The ClutterTimeline used by the animation.

    -

    Since 1.0

    +

    +

    +

    Since 1.0

    Signal Details

    The "completed" signal

    -
    void                user_function                      (ClutterAnimation *animation,
    -                                                        gpointer          user_data)      : Run Last
    +
    void                user_function                      (ClutterAnimation *animation,
    +                                                        gpointer          user_data)      : Run Last

    The ::completed signal is emitted once the animation has been completed. @@ -1825,6 +2110,8 @@

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

    +

    +

    @@ -1839,16 +2126,20 @@
    -

    Since 1.0

    +

    Since 1.0


    The "started" signal

    -
    void                user_function                      (ClutterAnimation *animation,
    -                                                        gpointer          user_data)      : Run Last
    +
    void                user_function                      (ClutterAnimation *animation,
    +                                                        gpointer          user_data)      : Run Last

    The ::started signal is emitted once the animation has been started

    +

    +

    @@ -1863,17 +2154,17 @@
    -

    Since 1.0

    +

    Since 1.0

    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ClutterFixedLayout.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ClutterFixedLayout.html @@ -8,7 +8,7 @@ - + @@ -62,10 +62,10 @@ Top -  |  - Description -  |  - Object Hierarchy +  |  + Description +  |  + Object Hierarchy
    @@ -79,16 +79,21 @@

    Object Hierarchy

    -  GObject
    -   +----GInitiallyUnowned
    +  GObject
    +   +----GInitiallyUnowned
              +----ClutterLayoutManager
                    +----ClutterFixedLayout
     
    @@ -101,6 +106,8 @@

    ClutterFixedLayout is available since Clutter 1.2

    +

    +

    Details

    @@ -110,6 +117,8 @@

    The ClutterFixedLayout structure contains only private data and it should be accessed using the provided API

    +

    +

    Since 1.2


    @@ -121,14 +130,18 @@

    The ClutterFixedLayoutClass structure contains only private data and it should be accessed using the provided API

    +

    +

    Since 1.2


    clutter_fixed_layout_new ()

    -
    ClutterLayoutManager * clutter_fixed_layout_new         (void);
    +
    ClutterLayoutManager * clutter_fixed_layout_new         (void);

    Creates a new ClutterFixedLayout

    +

    +

    @@ -144,6 +157,6 @@ + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ch08.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ch08.html @@ -8,7 +8,7 @@ - + @@ -61,7 +61,7 @@

    -General purpose API

    +General purpose API
    Colors — Color management and manipulation. @@ -103,6 +103,6 @@
    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ClutterListModel.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ClutterListModel.html @@ -8,7 +8,7 @@ - + @@ -62,12 +62,12 @@ Top -  |  - Description -  |  - Object Hierarchy -  |  - Implemented Interfaces +  |  + Description +  |  + Object Hierarchy +  |  + Implemented Interfaces
    @@ -81,19 +81,30 @@

    Synopsis

    -
                        ClutterListModel;
    +
    +                    ClutterListModel;
                         ClutterListModelClass;
    -ClutterModel *      clutter_list_model_new              (guint n_columns,
    +ClutterModel *      clutter_list_model_new              (guint n_columns,
                                                              ...);
    -ClutterModel *      clutter_list_model_newv             (guint n_columns,
    -                                                         GType *types,
    -                                                         const gchar * const names[]);
    +ClutterModel *      clutter_list_model_newv             (guint n_columns,
    +                                                         GType *types,
    +                                                         const gchar * const names[]);
     

    Object Hierarchy

    -  GObject
    +  GObject
        +----ClutterModel
              +----ClutterListModel
     
    @@ -108,12 +119,16 @@

    Description

    ClutterListModel is a ClutterModel implementation provided by -Clutter. ClutterListModel uses a GSequence for storing the +Clutter. ClutterListModel uses a GSequence for storing the values for each row, so it's optimized for insertion and look up in sorted lists.

    ClutterListModel is available since Clutter 0.6

    +

    +

    Details

    @@ -122,6 +137,8 @@
    typedef struct _ClutterListModel ClutterListModel;

    The ClutterListModel struct contains only private data.

    +

    +

    Since 0.6


    @@ -132,12 +149,16 @@

    The ClutterListModelClass struct contains only private data.

    +

    +

    Since 0.6


    clutter_list_model_new ()

    -
    ClutterModel *      clutter_list_model_new              (guint n_columns,
    +
    ClutterModel *      clutter_list_model_new              (guint n_columns,
                                                              ...);

    Creates a new default model with n_columns columns with the types @@ -158,12 +179,16 @@

    will create a new ClutterModel with three columns of type int, -string and GdkPixbuf respectively. +string and GdkPixbuf respectively.

    -Note that the name of the column can be set to NULL, in which case +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.

    +

    +

    @@ -174,7 +199,9 @@ - @@ -190,12 +217,20 @@

    clutter_list_model_newv ()

    -
    ClutterModel *      clutter_list_model_newv             (guint n_columns,
    -                                                         GType *types,
    -                                                         const gchar * const names[]);
    +
    ClutterModel *      clutter_list_model_newv             (guint n_columns,
    +                                                         GType *types,
    +                                                         const gchar * const names[]);

    Non-vararg version of clutter_list_model_new(). This function is useful for language bindings.

    +

    +

    ... :

    n_columns number of GType and string pairs + n_columns number of GType and string pairs
    @@ -206,7 +241,9 @@ - @@ -228,6 +265,6 @@ + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/clutter-Value-intervals.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/clutter-Value-intervals.html @@ -8,7 +8,7 @@ - + @@ -62,12 +62,12 @@

    types :

    an array of GType types for the columns, from first to last + an array of GType types for the columns, from first to last
    Top -  |  - Description -  |  - Object Hierarchy -  |  - Properties +  |  + Description +  |  + Object Hierarchy +  |  + Properties
    @@ -81,57 +81,108 @@

    Synopsis

    -
                        ClutterInterval;
    +
    +                    ClutterInterval;
                         ClutterIntervalClass;
    -ClutterInterval *   clutter_interval_new                (GType gtype,
    +ClutterInterval *   clutter_interval_new                (GType gtype,
                                                              ...);
    -ClutterInterval *   clutter_interval_new_with_values    (GType gtype,
    -                                                         const GValue *initial,
    -                                                         const GValue *final);
    -ClutterInterval *   clutter_interval_clone              (ClutterInterval *interval);
    -GType               clutter_interval_get_value_type     (ClutterInterval *interval);
    -void                clutter_interval_set_initial_value  (ClutterInterval *interval,
    -                                                         const GValue *value);
    -void                clutter_interval_get_initial_value  (ClutterInterval *interval,
    -                                                         GValue *value);
    -GValue *            clutter_interval_peek_initial_value (ClutterInterval *interval);
    -void                clutter_interval_set_final_value    (ClutterInterval *interval,
    -                                                         const GValue *value);
    -void                clutter_interval_get_final_value    (ClutterInterval *interval,
    -                                                         GValue *value);
    -GValue *            clutter_interval_peek_final_value   (ClutterInterval *interval);
    -void                clutter_interval_set_interval       (ClutterInterval *interval,
    +ClutterInterval *   clutter_interval_new_with_values    (GType gtype,
    +                                                         const GValue *initial,
    +                                                         const GValue *final);
    +ClutterInterval *   clutter_interval_clone              (ClutterInterval *interval);
    +GType               clutter_interval_get_value_type     (ClutterInterval *interval);
    +void                clutter_interval_set_initial_value  (ClutterInterval *interval,
    +                                                         const GValue *value);
    +void                clutter_interval_get_initial_value  (ClutterInterval *interval,
    +                                                         GValue *value);
    +GValue *            clutter_interval_peek_initial_value (ClutterInterval *interval);
    +void                clutter_interval_set_final_value    (ClutterInterval *interval,
    +                                                         const GValue *value);
    +void                clutter_interval_get_final_value    (ClutterInterval *interval,
    +                                                         GValue *value);
    +GValue *            clutter_interval_peek_final_value   (ClutterInterval *interval);
    +void                clutter_interval_set_interval       (ClutterInterval *interval,
                                                              ...);
    -void                clutter_interval_get_interval       (ClutterInterval *interval,
    +void                clutter_interval_get_interval       (ClutterInterval *interval,
                                                              ...);
     
    -gboolean            clutter_interval_compute_value      (ClutterInterval *interval,
    -                                                         gdouble factor,
    -                                                         GValue *value);
    -gboolean            clutter_interval_validate           (ClutterInterval *interval,
    -                                                         GParamSpec *pspec);
    -
    -gboolean            (*ClutterProgressFunc)              (const GValue *a,
    -                                                         const GValue *b,
    -                                                         gdouble progress,
    -                                                         GValue *retval);
    -void                clutter_interval_register_progress_func
    -                                                        (GType value_type,
    -                                                         ClutterProgressFunc func);
    +gboolean            clutter_interval_compute_value      (ClutterInterval *interval,
    +                                                         gdouble factor,
    +                                                         GValue *value);
    +gboolean            clutter_interval_validate           (ClutterInterval *interval,
    +                                                         GParamSpec *pspec);
    +
    +gboolean            (*ClutterProgressFunc)              (const GValue *a,
    +                                                         const GValue *b,
    +                                                         gdouble progress,
    +                                                         GValue *retval);
    +void                clutter_interval_register_progress_func
    +                                                        (GType value_type,
    +                                                         ClutterProgressFunc func);
     

    Object Hierarchy

    -  GObject
    -   +----GInitiallyUnowned
    +  GObject
    +   +----GInitiallyUnowned
              +----ClutterInterval
     

    Properties

    -  "value-type"               GType*                : Read / Write / Construct Only
    +  "value-type"               GType*                : Read / Write / Construct Only
     
    @@ -139,16 +190,22 @@

    ClutterInterval is a simple object that can hold two values defining an interval. ClutterInterval can hold any value that -can be enclosed inside a GValue. +can be enclosed inside a GValue.

    -Once a ClutterInterval for a specific GType has been instantiated +Once a ClutterInterval for a specific GType has been instantiated the "value-type" property cannot be changed anymore.

    ClutterInterval starts with a floating reference; this means that any object taking a reference on a ClutterInterval instance should -also take ownership of the interval by using g_object_ref_sink(). +also take ownership of the interval by using g_object_ref_sink().

    ClutterInterval is used by ClutterAnimation to define the @@ -160,6 +217,8 @@

    ClutterInterval is available since Clutter 1.0

    +

    +

    Details

    @@ -169,6 +228,8 @@

    The ClutterInterval structure contains only private data and should be accessed using the provided functions.

    +

    +

    Since 1.0


    @@ -184,17 +245,21 @@

    The ClutterIntervalClass contains only private data.

    +

    +

    - + - + @@ -206,13 +271,17 @@

    clutter_interval_new ()

    -
    ClutterInterval *   clutter_interval_new                (GType gtype,
    +
    ClutterInterval *   clutter_interval_new                (GType gtype,
                                                              ...);

    Creates a new ClutterInterval holding values of type gtype.

    -This function avoids using a GValue for the initial and final values +This function avoids using a GValue for the initial and final values of the interval:

    @@ -222,6 +291,8 @@ interval = clutter_interval_new (G_TYPE_BOOLEAN, FALSE, TRUE); interval = clutter_interval_new (G_TYPE_INT, 0, 360);

    +

    +

    validate ()

    validate ()

    virtual function for validating an interval - using a GParamSpec + using a GParamSpec

    compute_value ()

    compute_value ()

    virtual function for computing the value inside an interval using an adimensional factor between 0 and 1
    @@ -248,15 +319,23 @@

    clutter_interval_new_with_values ()

    -
    ClutterInterval *   clutter_interval_new_with_values    (GType gtype,
    -                                                         const GValue *initial,
    -                                                         const GValue *final);
    +
    ClutterInterval *   clutter_interval_new_with_values    (GType gtype,
    +                                                         const GValue *initial,
    +                                                         const GValue *final);

    Creates a new ClutterInterval of type gtype, between initial and final.

    This function is useful for language bindings.

    +

    +

    @@ -267,12 +346,16 @@ - - @@ -288,9 +371,11 @@

    clutter_interval_clone ()

    -
    ClutterInterval *   clutter_interval_clone              (ClutterInterval *interval);
    +
    ClutterInterval *   clutter_interval_clone              (ClutterInterval *interval);

    Creates a copy of interval.

    +

    +

    initial :

    a GValue holding the initial value of the interval + a GValue holding the initial value of the interval

    final :

    a GValue holding the final value of the interval + a GValue holding the final value of the interval
    @@ -312,9 +397,15 @@

    clutter_interval_get_value_type ()

    -
    GType               clutter_interval_get_value_type     (ClutterInterval *interval);
    +
    GType               clutter_interval_get_value_type     (ClutterInterval *interval);
    +

    +Retrieves the GType of the values inside interval.

    -Retrieves the GType of the values inside interval.

    +

    @@ -336,11 +427,15 @@

    clutter_interval_set_initial_value ()

    -
    void                clutter_interval_set_initial_value  (ClutterInterval *interval,
    -                                                         const GValue *value);
    +
    void                clutter_interval_set_initial_value  (ClutterInterval *interval,
    +                                                         const GValue *value);

    Sets the initial value of interval to value. The value is copied inside the ClutterInterval.

    +

    +

    @@ -351,7 +446,9 @@ - @@ -361,15 +458,21 @@

    clutter_interval_get_initial_value ()

    -
    void                clutter_interval_get_initial_value  (ClutterInterval *interval,
    -                                                         GValue *value);
    +
    void                clutter_interval_get_initial_value  (ClutterInterval *interval,
    +                                                         GValue *value);

    Retrieves the initial value of interval and copies it into value.

    -The passed GValue must be initialized to the value held by +The passed GValue must be initialized to the value held by the ClutterInterval.

    +

    +

    value :

    a GValue + a GValue
    @@ -380,7 +483,9 @@ - @@ -390,9 +495,13 @@

    clutter_interval_peek_initial_value ()

    -
    GValue *            clutter_interval_peek_initial_value (ClutterInterval *interval);
    +
    GValue *            clutter_interval_peek_initial_value (ClutterInterval *interval);

    Gets the pointer to the initial value of interval

    +

    +

    value :

    a GValue + a GValue
    @@ -403,7 +512,7 @@ - +

    Returns :

    transfer none. transfer none. transfer none. transfer none.
    @@ -412,11 +521,15 @@

    clutter_interval_set_final_value ()

    -
    void                clutter_interval_set_final_value    (ClutterInterval *interval,
    -                                                         const GValue *value);
    +
    void                clutter_interval_set_final_value    (ClutterInterval *interval,
    +                                                         const GValue *value);

    Sets the final value of interval to value. The value is copied inside the ClutterInterval.

    +

    +

    @@ -427,7 +540,9 @@ - @@ -437,15 +552,21 @@

    clutter_interval_get_final_value ()

    -
    void                clutter_interval_get_final_value    (ClutterInterval *interval,
    -                                                         GValue *value);
    +
    void                clutter_interval_get_final_value    (ClutterInterval *interval,
    +                                                         GValue *value);

    Retrieves the final value of interval and copies it into value.

    -The passed GValue must be initialized to the value held by +The passed GValue must be initialized to the value held by the ClutterInterval.

    +

    +

    value :

    a GValue + a GValue
    @@ -456,7 +577,9 @@ - @@ -466,9 +589,13 @@

    clutter_interval_peek_final_value ()

    -
    GValue *            clutter_interval_peek_final_value   (ClutterInterval *interval);
    +
    GValue *            clutter_interval_peek_final_value   (ClutterInterval *interval);

    Gets the pointer to the final value of interval

    +

    +

    value :

    a GValue + a GValue
    @@ -479,7 +606,7 @@ - +

    Returns :

    transfer none. transfer none. transfer none. transfer none.
    @@ -488,12 +615,14 @@

    clutter_interval_set_interval ()

    -
    void                clutter_interval_set_interval       (ClutterInterval *interval,
    +
    void                clutter_interval_set_interval       (ClutterInterval *interval,
                                                              ...);

    Variable arguments wrapper for clutter_interval_set_initial_value() and clutter_interval_set_final_value() that avoids using the -GValue arguments: +GValue arguments:

    @@ -507,6 +636,8 @@

    This function is meant for the convenience of the C API; bindings should reimplement this function using the GValue-based API.

    +

    +

    @@ -527,12 +658,14 @@

    clutter_interval_get_interval ()

    -
    void                clutter_interval_get_interval       (ClutterInterval *interval,
    +
    void                clutter_interval_get_interval       (ClutterInterval *interval,
                                                              ...);

    Variable arguments wrapper for clutter_interval_get_initial_value() and clutter_interval_get_final_value() that avoids using the -GValue arguments: +GValue arguments:

    @@ -545,6 +678,8 @@

    This function is meant for the convenience of the C API; bindings should reimplement this function using the GValue-based API.

    +

    +

    @@ -566,12 +701,20 @@

    clutter_interval_compute_value ()

    -
    gboolean            clutter_interval_compute_value      (ClutterInterval *interval,
    -                                                         gdouble factor,
    -                                                         GValue *value);
    +
    gboolean            clutter_interval_compute_value      (ClutterInterval *interval,
    +                                                         gdouble factor,
    +                                                         GValue *value);

    Computes the value between the interval boundaries given the progress factor and puts it into value.

    +

    +

    @@ -587,12 +730,14 @@ - - @@ -603,11 +748,19 @@

    clutter_interval_validate ()

    -
    gboolean            clutter_interval_validate           (ClutterInterval *interval,
    -                                                         GParamSpec *pspec);
    +
    gboolean            clutter_interval_validate           (ClutterInterval *interval,
    +                                                         GParamSpec *pspec);

    Validates the initial and final values of interval against -a GParamSpec.

    +a GParamSpec.

    +

    +

    value :

    return location for an initialized GValue + return location for an initialized GValue

    Returns :

    TRUE if the operation was successful + TRUE if the operation was successful
    @@ -618,12 +771,14 @@ - - @@ -634,23 +789,37 @@

    ClutterProgressFunc ()

    -
    gboolean            (*ClutterProgressFunc)              (const GValue *a,
    -                                                         const GValue *b,
    -                                                         gdouble progress,
    -                                                         GValue *retval);
    +
    gboolean            (*ClutterProgressFunc)              (const GValue *a,
    +                                                         const GValue *b,
    +                                                         gdouble progress,
    +                                                         GValue *retval);

    Prototype of the progress function used to compute the value between the two ends a and b of an interval depending on the value of progress.

    -The GValue in retval is already initialized with the same +The GValue in retval is already initialized with the same type as a and b.

    This function will be called by ClutterInterval if the type of the values of the interval was registered using clutter_interval_register_progress_func().

    +

    +

    pspec :

    a GParamSpec + a GParamSpec

    Returns :

    TRUE if the ClutterInterval is valid, FALSE otherwise + TRUE if the ClutterInterval is valid, FALSE otherwise
    @@ -676,7 +845,7 @@ - @@ -688,9 +857,11 @@

    clutter_interval_register_progress_func ()

    -
    void                clutter_interval_register_progress_func
    -                                                        (GType value_type,
    -                                                         ClutterProgressFunc func);
    +
    void                clutter_interval_register_progress_func
    +                                                        (GType value_type,
    +                                                         ClutterProgressFunc func);

    Sets the progress function for a given value_type, like:

    @@ -705,7 +876,9 @@

    Whenever a ClutterInterval instance using the default "compute_value" implementation is set as an -interval between two GValue of type value_type, it will call +interval between two GValue of type value_type, it will call func to establish the value depending on the given progress, for instance:

    @@ -732,19 +905,25 @@

    -To unset a previously set progress function of a GType, pass NULL +To unset a previously set progress function of a GType, pass NULL for func.

    +

    +

    Returns :

    TRUE if the function successfully computed + TRUE if the function successfully computed the value and stored it inside retval
    - - @@ -757,15 +936,19 @@

    Property Details

    The "value-type" property

    -
      "value-type"               GType*                : Read / Write / Construct Only
    +
      "value-type"               GType*                : Read / Write / Construct Only

    The type of the values in the interval.

    -

    Since 1.0

    +

    +

    +

    Since 1.0

    + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ix05.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ix05.html @@ -8,7 +8,7 @@ - + @@ -52,44 +52,20 @@ -

    value_type :

    a GType + a GType

    func :

    a ClutterProgressFunc, or NULL to unset a previously + a ClutterProgressFunc, or NULL to unset a previously set progress function
    - + - - - +

    -Index of new symbols in 0.6

    -

    A

    +Index of new symbols in 0.6
    +
    + + + + +
    +

    F

    +
    ClutterFog
    -

    G

    +
    +
    + + + + + + + +
    +
    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ClutterInputDevice.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ClutterInputDevice.html @@ -8,7 +8,7 @@ - + @@ -62,12 +62,12 @@ Top -  |  - Description -  |  - Object Hierarchy -  |  - Properties +  |  + Description +  |  + Object Hierarchy +  |  + Properties
    @@ -81,41 +81,58 @@

    Object Hierarchy

    -  GObject
    +  GObject
        +----ClutterInputDevice
     

    Properties

    -  "device-type"              ClutterInputDeviceType  : Read / Write / Construct Only
    -  "id"                       gint                  : Read / Write / Construct Only
    -  "name"                     gchar*                : Read / Write / Construct Only
    +  "device-type"              ClutterInputDeviceType  : Read / Write / Construct Only
    +  "id"                       gint                  : Read / Write / Construct Only
    +  "name"                     gchar*                : Read / Write / Construct Only
     
    @@ -126,6 +143,8 @@

    The ClutterInputDevice class holds the state of the device, but its contents are usually defined by the Clutter backend in use.

    +

    +

    Details

    @@ -145,26 +164,28 @@

    The ClutterInputDeviceType enumeration can be extended at later date; not every platform supports every input device type.

    +

    +

    - + - + - + - + @@ -179,6 +200,8 @@

    Generic representation of an input device. The actual contents of this structure depend on the backend used.

    +

    +


    @@ -189,14 +212,20 @@

    The ClutterInputDeviceClass structure contains only private data and should not be accessed directly

    +

    +

    Since 1.2


    clutter_input_device_get_device_id ()

    -
    gint                clutter_input_device_get_device_id  (ClutterInputDevice *device);
    +
    gint                clutter_input_device_get_device_id  (ClutterInputDevice *device);

    Retrieves the unique identifier of device

    +

    +

    CLUTTER_POINTER_DEVICE

    CLUTTER_POINTER_DEVICE

    A pointer device

    CLUTTER_KEYBOARD_DEVICE

    CLUTTER_KEYBOARD_DEVICE

    A keyboard device

    CLUTTER_EXTENSION_DEVICE

    CLUTTER_EXTENSION_DEVICE

    A generic extension device

    CLUTTER_N_DEVICE_TYPES

    CLUTTER_N_DEVICE_TYPES

    The number of device types
    @@ -218,10 +247,12 @@

    clutter_input_device_get_device_type ()

    -
    ClutterInputDeviceType  clutter_input_device_get_device_type
    -                                                        (ClutterInputDevice *device);
    +
    ClutterInputDeviceType  clutter_input_device_get_device_type
    +                                                        (ClutterInputDevice *device);

    Retrieves the type of device

    +

    +

    @@ -243,10 +274,14 @@

    clutter_input_device_get_device_name ()

    -
    const gchar *       clutter_input_device_get_device_name
    -                                                        (ClutterInputDevice *device);
    +
    const gchar *       clutter_input_device_get_device_name
    +                                                        (ClutterInputDevice *device);

    Retrieves the name of the device

    +

    +

    @@ -257,7 +292,7 @@ -

    Returns :

    the name of the device, or NULL. The returned string + the name of the device, or NULL. The returned string is owned by the ClutterInputDevice and should never be modified or freed @@ -270,27 +305,33 @@

    clutter_input_device_get_device_coords ()

    -
    void                clutter_input_device_get_device_coords
    -                                                        (ClutterInputDevice *device,
    -                                                         gint *x,
    -                                                         gint *y);
    +
    void                clutter_input_device_get_device_coords
    +                                                        (ClutterInputDevice *device,
    +                                                         gint *x,
    +                                                         gint *y);

    Retrieves the latest coordinates of the pointer of device

    +

    +

    - - + - +

    device :

    a ClutterInputDevice of type CLUTTER_POINTER_DEVICE + a ClutterInputDevice of type CLUTTER_POINTER_DEVICE

    x :

    return location for the X coordinate. out. return location for the X coordinate. out.

    y :

    return location for the Y coordinate. out. return location for the Y coordinate. out.
    @@ -299,21 +340,23 @@

    clutter_input_device_get_pointer_actor ()

    -
    ClutterActor *      clutter_input_device_get_pointer_actor
    -                                                        (ClutterInputDevice *device);
    +
    ClutterActor *      clutter_input_device_get_pointer_actor
    +                                                        (ClutterInputDevice *device);

    Retrieves the ClutterActor underneath the pointer of device

    +

    +

    - - +

    device :

    a ClutterInputDevice of type CLUTTER_POINTER_DEVICE + a ClutterInputDevice of type CLUTTER_POINTER_DEVICE

    Returns :

    a pointer to the ClutterActor or NULL. transfer none. a pointer to the ClutterActor or NULL. transfer none.
    @@ -322,21 +365,23 @@

    clutter_input_device_get_pointer_stage ()

    -
    ClutterStage *      clutter_input_device_get_pointer_stage
    -                                                        (ClutterInputDevice *device);
    +
    ClutterStage *      clutter_input_device_get_pointer_stage
    +                                                        (ClutterInputDevice *device);

    Retrieves the ClutterStage underneath the pointer of device

    +

    +

    - - +

    device :

    a ClutterInputDevice of type CLUTTER_POINTER_DEVICE + a ClutterInputDevice of type CLUTTER_POINTER_DEVICE

    Returns :

    a pointer to the ClutterStage or NULL. transfer none. a pointer to the ClutterStage or NULL. transfer none.
    @@ -345,10 +390,12 @@

    clutter_input_device_update_from_event ()

    -
    void                clutter_input_device_update_from_event
    -                                                        (ClutterInputDevice *device,
    -                                                         ClutterEvent *event,
    -                                                         gboolean update_stage);
    +
    void                clutter_input_device_update_from_event
    +                                                        (ClutterInputDevice *device,
    +                                                         ClutterEvent *event,
    +                                                         gboolean update_stage);

    Forcibly updates the state of the device using a ClutterEvent

    @@ -362,8 +409,8 @@ 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 +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.

    @@ -414,6 +461,8 @@ 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.

    +

    +

    @@ -442,35 +491,45 @@

    Property Details

    The "device-type" property

    -
      "device-type"              ClutterInputDeviceType  : Read / Write / Construct Only
    +
      "device-type"              ClutterInputDeviceType  : Read / Write / Construct Only

    The type of the device

    +

    +

    Default value: CLUTTER_POINTER_DEVICE

    -

    Since 1.2

    +

    Since 1.2


    The "id" property

    -
      "id"                       gint                  : Read / Write / Construct Only
    +
      "id"                       gint                  : Read / Write / Construct Only

    The unique identifier of the device

    +

    +

    Allowed values: >= -1

    Default value: 0

    -

    Since 1.2

    +

    Since 1.2


    The "name" property

    -
      "name"                     gchar*                : Read / Write / Construct Only
    +
      "name"                     gchar*                : Read / Write / Construct Only

    The name of the device

    +

    +

    Default value: NULL

    -

    Since 1.2

    +

    Since 1.2

    + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ch07.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ch07.html @@ -8,7 +8,7 @@ - + @@ -61,7 +61,7 @@

    -High Level API

    +High Level API
    Value intervals — An object holding an interval of two values @@ -79,6 +79,6 @@
    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ClutterLayoutManager.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ClutterLayoutManager.html @@ -8,7 +8,7 @@ - + @@ -62,12 +62,12 @@
    Top -  |  - Description -  |  - Object Hierarchy -  |  - Signals +  |  + Description +  |  + Object Hierarchy +  |  + Signals
    @@ -81,79 +81,122 @@

    Synopsis

    -
                        ClutterLayoutManager;
    +
    +                    ClutterLayoutManager;
                         ClutterLayoutManagerClass;
    -void                clutter_layout_manager_get_preferred_width
    -                                                        (ClutterLayoutManager *manager,
    -                                                         ClutterContainer *container,
    -                                                         gfloat for_height,
    -                                                         gfloat *min_width_p,
    -                                                         gfloat *nat_width_p);
    -void                clutter_layout_manager_get_preferred_height
    -                                                        (ClutterLayoutManager *manager,
    -                                                         ClutterContainer *container,
    -                                                         gfloat for_width,
    -                                                         gfloat *min_height_p,
    -                                                         gfloat *nat_height_p);
    -void                clutter_layout_manager_allocate     (ClutterLayoutManager *manager,
    -                                                         ClutterContainer *container,
    -                                                         const ClutterActorBox *allocation,
    -                                                         ClutterAllocationFlags flags);
    -void                clutter_layout_manager_layout_changed
    -                                                        (ClutterLayoutManager *manager);
    -void                clutter_layout_manager_set_container
    -                                                        (ClutterLayoutManager *manager,
    -                                                         ClutterContainer *container);
    -
    -ClutterLayoutMeta * clutter_layout_manager_get_child_meta
    -                                                        (ClutterLayoutManager *manager,
    -                                                         ClutterContainer *container,
    -                                                         ClutterActor *actor);
    -void                clutter_layout_manager_child_set    (ClutterLayoutManager *manager,
    -                                                         ClutterContainer *container,
    -                                                         ClutterActor *actor,
    -                                                         const gchar *first_property,
    +void                clutter_layout_manager_get_preferred_width
    +                                                        (ClutterLayoutManager *manager,
    +                                                         ClutterContainer *container,
    +                                                         gfloat for_height,
    +                                                         gfloat *min_width_p,
    +                                                         gfloat *nat_width_p);
    +void                clutter_layout_manager_get_preferred_height
    +                                                        (ClutterLayoutManager *manager,
    +                                                         ClutterContainer *container,
    +                                                         gfloat for_width,
    +                                                         gfloat *min_height_p,
    +                                                         gfloat *nat_height_p);
    +void                clutter_layout_manager_allocate     (ClutterLayoutManager *manager,
    +                                                         ClutterContainer *container,
    +                                                         const ClutterActorBox *allocation,
    +                                                         ClutterAllocationFlags flags);
    +void                clutter_layout_manager_layout_changed
    +                                                        (ClutterLayoutManager *manager);
    +void                clutter_layout_manager_set_container
    +                                                        (ClutterLayoutManager *manager,
    +                                                         ClutterContainer *container);
    +
    +ClutterLayoutMeta * clutter_layout_manager_get_child_meta
    +                                                        (ClutterLayoutManager *manager,
    +                                                         ClutterContainer *container,
    +                                                         ClutterActor *actor);
    +void                clutter_layout_manager_child_set    (ClutterLayoutManager *manager,
    +                                                         ClutterContainer *container,
    +                                                         ClutterActor *actor,
    +                                                         const gchar *first_property,
                                                              ...);
    -void                clutter_layout_manager_child_set_property
    -                                                        (ClutterLayoutManager *manager,
    -                                                         ClutterContainer *container,
    -                                                         ClutterActor *actor,
    -                                                         const gchar *property_name,
    -                                                         const GValue *value);
    -void                clutter_layout_manager_child_get    (ClutterLayoutManager *manager,
    -                                                         ClutterContainer *container,
    -                                                         ClutterActor *actor,
    -                                                         const gchar *first_property,
    +void                clutter_layout_manager_child_set_property
    +                                                        (ClutterLayoutManager *manager,
    +                                                         ClutterContainer *container,
    +                                                         ClutterActor *actor,
    +                                                         const gchar *property_name,
    +                                                         const GValue *value);
    +void                clutter_layout_manager_child_get    (ClutterLayoutManager *manager,
    +                                                         ClutterContainer *container,
    +                                                         ClutterActor *actor,
    +                                                         const gchar *first_property,
                                                              ...);
    -void                clutter_layout_manager_child_get_property
    -                                                        (ClutterLayoutManager *manager,
    -                                                         ClutterContainer *container,
    -                                                         ClutterActor *actor,
    -                                                         const gchar *property_name,
    -                                                         GValue *value);
    -
    -GParamSpec *        clutter_layout_manager_find_child_property
    -                                                        (ClutterLayoutManager *manager,
    -                                                         const gchar *name);
    -GParamSpec **       clutter_layout_manager_list_child_properties
    -                                                        (ClutterLayoutManager *manager,
    -                                                         guint *n_pspecs);
    -
    -ClutterAlpha *      clutter_layout_manager_begin_animation
    -                                                        (ClutterLayoutManager *manager,
    -                                                         guint duration,
    -                                                         gulong mode);
    -void                clutter_layout_manager_end_animation
    -                                                        (ClutterLayoutManager *manager);
    -gdouble             clutter_layout_manager_get_animation_progress
    -                                                        (ClutterLayoutManager *manager);
    +void                clutter_layout_manager_child_get_property
    +                                                        (ClutterLayoutManager *manager,
    +                                                         ClutterContainer *container,
    +                                                         ClutterActor *actor,
    +                                                         const gchar *property_name,
    +                                                         GValue *value);
    +
    +GParamSpec *        clutter_layout_manager_find_child_property
    +                                                        (ClutterLayoutManager *manager,
    +                                                         const gchar *name);
    +GParamSpec **       clutter_layout_manager_list_child_properties
    +                                                        (ClutterLayoutManager *manager,
    +                                                         guint *n_pspecs);
    +
    +ClutterAlpha *      clutter_layout_manager_begin_animation
    +                                                        (ClutterLayoutManager *manager,
    +                                                         guint duration,
    +                                                         gulong mode);
    +void                clutter_layout_manager_end_animation
    +                                                        (ClutterLayoutManager *manager);
    +gdouble             clutter_layout_manager_get_animation_progress
    +                                                        (ClutterLayoutManager *manager);
     

    Object Hierarchy

    -  GObject
    -   +----GInitiallyUnowned
    +  GObject
    +   +----GInitiallyUnowned
              +----ClutterLayoutManager
                    +----ClutterFixedLayout
                    +----ClutterBinLayout
    @@ -219,12 +262,14 @@
     

    The implementation of a layout manager does not differ from the implementation of the size requisition and allocation bits of ClutterActor, so you should read the relative documentation - for subclassing - ClutterActor.

    + for subclassing + ClutterActor.

    The layout manager implementation can hold a back pointer to the ClutterContainer by implementing the set_container() virtual function. The layout manager - should not hold a real reference (i.e. call g_object_ref()) on the + should not hold a real reference (i.e. call g_object_ref()) on the container actor, to avoid reference cycles.

    If the layout manager has properties affecting the layout policies then it should emit the "layout-changed" @@ -235,7 +280,9 @@ manager, container actor, child actor) combination, and it wishes to store those properties inside a ClutterLayoutMeta then it should override the ClutterLayoutManager::get_child_meta_type() - virtual function to return the GType of the ClutterLayoutMeta sub-class + virtual function to return the GType of the ClutterLayoutMeta sub-class used to store the layout properties; optionally, the ClutterLayoutManager sub-class might also override the ClutterLayoutManager::create_child_meta() virtual @@ -439,6 +486,8 @@

    ClutterLayoutManager is available since Clutter 1.2

    +

    +

    Details

    @@ -448,6 +497,8 @@

    The ClutterLayoutManager structure contains only private data and should be accessed using the provided API

    +

    +

    Since 1.2


    @@ -491,32 +542,34 @@

    The ClutterLayoutManagerClass structure contains only private data and should be accessed using the provided API

    +

    +

    - + - + - + - + - - + - + - + - + - + - + @@ -567,18 +622,26 @@

    clutter_layout_manager_get_preferred_width ()

    -
    void                clutter_layout_manager_get_preferred_width
    -                                                        (ClutterLayoutManager *manager,
    -                                                         ClutterContainer *container,
    -                                                         gfloat for_height,
    -                                                         gfloat *min_width_p,
    -                                                         gfloat *nat_width_p);
    +
    void                clutter_layout_manager_get_preferred_width
    +                                                        (ClutterLayoutManager *manager,
    +                                                         ClutterContainer *container,
    +                                                         gfloat for_height,
    +                                                         gfloat *min_width_p,
    +                                                         gfloat *nat_width_p);

    Computes the minimum and natural widths of the container according to manager.

    See also clutter_actor_get_preferred_width()

    +

    +

    get_preferred_width ()

    get_preferred_width ()

    virtual function; override to provide a preferred width for the layout manager. See also the get_preferred_width() virtual function in ClutterActor

    get_preferred_height ()

    get_preferred_height ()

    virtual function; override to provide a preferred height for the layout manager. See also the get_preferred_height() virtual function in ClutterActor

    allocate ()

    allocate ()

    virtual function; override to allocate the children of the layout manager. See also the allocate() virtual function in ClutterActor

    set_container ()

    set_container ()

    virtual function; override to set a back pointer on the ClutterContainer using the layout manager. The implementation should not take a reference on the container, but just take a weak @@ -524,38 +577,40 @@

    get_child_meta_type ()

    virtual function; override to return the GType +

    get_child_meta_type ()

    virtual function; override to return the GType of the ClutterLayoutMeta sub-class used by the ClutterLayoutManager

    create_child_meta ()

    create_child_meta ()

    virtual function; override to create a ClutterLayoutMeta instance associated to a ClutterContainer and a child ClutterActor, used to maintain layout manager specific properties

    begin_animation ()

    begin_animation ()

    virtual function; override to control the animation of a ClutterLayoutManager with the given duration and easing mode

    get_animation_progress ()

    get_animation_progress ()

    virtual function; override to control the progress of the animation of a ClutterLayoutManager

    end_animation ()

    end_animation ()

    virtual function; override to end an animation started by clutter_layout_manager_begin_animation()

    layout_changed ()

    layout_changed ()

    class handler for the "layout-changed" signal
    @@ -599,11 +662,11 @@ - + - +

    min_width_p :

    out) (allow-none. out. allow-none. out) (allow-none. out. allow-none.

    nat_width_p :

    out) (allow-none. out. allow-none. out) (allow-none. out. allow-none.
    @@ -612,18 +675,26 @@

    clutter_layout_manager_get_preferred_height ()

    -
    void                clutter_layout_manager_get_preferred_height
    -                                                        (ClutterLayoutManager *manager,
    -                                                         ClutterContainer *container,
    -                                                         gfloat for_width,
    -                                                         gfloat *min_height_p,
    -                                                         gfloat *nat_height_p);
    +
    void                clutter_layout_manager_get_preferred_height
    +                                                        (ClutterLayoutManager *manager,
    +                                                         ClutterContainer *container,
    +                                                         gfloat for_width,
    +                                                         gfloat *min_height_p,
    +                                                         gfloat *nat_height_p);

    Computes the minimum and natural heights of the container according to manager.

    See also clutter_actor_get_preferred_height()

    +

    +

    @@ -644,11 +715,11 @@ - + - +

    min_height_p :

    out) (allow-none. out. allow-none. out) (allow-none. out. allow-none.

    nat_height_p :

    out) (allow-none. out. allow-none. out) (allow-none. out. allow-none.
    @@ -657,15 +728,17 @@

    clutter_layout_manager_allocate ()

    -
    void                clutter_layout_manager_allocate     (ClutterLayoutManager *manager,
    -                                                         ClutterContainer *container,
    -                                                         const ClutterActorBox *allocation,
    -                                                         ClutterAllocationFlags flags);
    +
    void                clutter_layout_manager_allocate     (ClutterLayoutManager *manager,
    +                                                         ClutterContainer *container,
    +                                                         const ClutterActorBox *allocation,
    +                                                         ClutterAllocationFlags flags);

    Allocates the children of container given an area

    See also clutter_actor_allocate()

    +

    +

    @@ -697,14 +770,16 @@

    clutter_layout_manager_layout_changed ()

    -
    void                clutter_layout_manager_layout_changed
    -                                                        (ClutterLayoutManager *manager);
    +
    void                clutter_layout_manager_layout_changed
    +                                                        (ClutterLayoutManager *manager);

    Emits the "layout-changed" signal on manager

    This function should only be called by implementations of the ClutterLayoutManager class

    +

    +

    @@ -718,9 +793,9 @@

    clutter_layout_manager_set_container ()

    -
    void                clutter_layout_manager_set_container
    -                                                        (ClutterLayoutManager *manager,
    -                                                         ClutterContainer *container);
    +
    void                clutter_layout_manager_set_container
    +                                                        (ClutterLayoutManager *manager,
    +                                                         ClutterContainer *container);

    If the ClutterLayoutManager sub-class allows it, allow adding a weak reference of the container using manager @@ -729,6 +804,8 @@

    The layout manager should not increase the reference count of the container

    +

    +

    @@ -739,7 +816,7 @@ - +

    container :

    a ClutterContainer using manager. allow-none. a ClutterContainer using manager. allow-none.
    @@ -748,14 +825,16 @@

    clutter_layout_manager_get_child_meta ()

    -
    ClutterLayoutMeta * clutter_layout_manager_get_child_meta
    -                                                        (ClutterLayoutManager *manager,
    -                                                         ClutterContainer *container,
    -                                                         ClutterActor *actor);
    +
    ClutterLayoutMeta * clutter_layout_manager_get_child_meta
    +                                                        (ClutterLayoutManager *manager,
    +                                                         ClutterContainer *container,
    +                                                         ClutterActor *actor);

    Retrieves the ClutterLayoutMeta that the layout manager associated to the actor child of container, eventually by creating one if the ClutterLayoutManager supports layout properties

    +

    +

    @@ -776,7 +855,7 @@ - @@ -788,10 +867,12 @@

    clutter_layout_manager_child_set ()

    -
    void                clutter_layout_manager_child_set    (ClutterLayoutManager *manager,
    -                                                         ClutterContainer *container,
    -                                                         ClutterActor *actor,
    -                                                         const gchar *first_property,
    +
    void                clutter_layout_manager_child_set    (ClutterLayoutManager *manager,
    +                                                         ClutterContainer *container,
    +                                                         ClutterActor *actor,
    +                                                         const gchar *first_property,
                                                              ...);

    Sets a list of properties and their values on the ClutterLayoutMeta @@ -800,6 +881,8 @@

    Languages bindings should use clutter_layout_manager_child_set_property() instead

    +

    +

    Returns :

    a ClutterLayoutMeta, or NULL if the ClutterLayoutManager + a ClutterLayoutMeta, or NULL if the ClutterLayoutManager does not have layout properties
    @@ -835,15 +918,21 @@

    clutter_layout_manager_child_set_property ()

    -
    void                clutter_layout_manager_child_set_property
    -                                                        (ClutterLayoutManager *manager,
    -                                                         ClutterContainer *container,
    -                                                         ClutterActor *actor,
    -                                                         const gchar *property_name,
    -                                                         const GValue *value);
    +
    void                clutter_layout_manager_child_set_property
    +                                                        (ClutterLayoutManager *manager,
    +                                                         ClutterContainer *container,
    +                                                         ClutterActor *actor,
    +                                                         const gchar *property_name,
    +                                                         const GValue *value);

    Sets a property on the ClutterLayoutMeta created by manager and attached to a child of container

    +

    +

    @@ -869,7 +958,9 @@ - @@ -879,15 +970,19 @@

    clutter_layout_manager_child_get ()

    -
    void                clutter_layout_manager_child_get    (ClutterLayoutManager *manager,
    -                                                         ClutterContainer *container,
    -                                                         ClutterActor *actor,
    -                                                         const gchar *first_property,
    +
    void                clutter_layout_manager_child_get    (ClutterLayoutManager *manager,
    +                                                         ClutterContainer *container,
    +                                                         ClutterActor *actor,
    +                                                         const gchar *first_property,
                                                              ...);

    Retrieves the values for a list of properties out of the ClutterLayoutMeta created by manager and attached to the child of a container

    +

    +

    value :

    a GValue with the value of the property to set + a GValue with the value of the property to set
    @@ -923,20 +1018,30 @@

    clutter_layout_manager_child_get_property ()

    -
    void                clutter_layout_manager_child_get_property
    -                                                        (ClutterLayoutManager *manager,
    -                                                         ClutterContainer *container,
    -                                                         ClutterActor *actor,
    -                                                         const gchar *property_name,
    -                                                         GValue *value);
    +
    void                clutter_layout_manager_child_get_property
    +                                                        (ClutterLayoutManager *manager,
    +                                                         ClutterContainer *container,
    +                                                         ClutterActor *actor,
    +                                                         const gchar *property_name,
    +                                                         GValue *value);

    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 +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

    +

    +

    @@ -962,7 +1067,9 @@ - @@ -972,12 +1079,20 @@

    clutter_layout_manager_find_child_property ()

    -
    GParamSpec *        clutter_layout_manager_find_child_property
    -                                                        (ClutterLayoutManager *manager,
    -                                                         const gchar *name);
    -

    -Retrieves the GParamSpec for the layout property name inside +

    GParamSpec *        clutter_layout_manager_find_child_property
    +                                                        (ClutterLayoutManager *manager,
    +                                                         const gchar *name);
    +

    +Retrieves the GParamSpec for the layout property name inside the ClutterLayoutMeta sub-class used by manager

    +

    +

    value :

    a GValue with the value of the property to get + a GValue with the value of the property to get
    @@ -993,7 +1108,7 @@ - +

    Returns :

    transfer none. transfer none. transfer none. transfer none.
    @@ -1002,12 +1117,20 @@

    clutter_layout_manager_list_child_properties ()

    -
    GParamSpec **       clutter_layout_manager_list_child_properties
    -                                                        (ClutterLayoutManager *manager,
    -                                                         guint *n_pspecs);
    -

    -Retrieves all the GParamSpecs for the layout properties +

    GParamSpec **       clutter_layout_manager_list_child_properties
    +                                                        (ClutterLayoutManager *manager,
    +                                                         guint *n_pspecs);
    +

    +Retrieves all the GParamSpecs for the layout properties stored inside the ClutterLayoutMeta sub-class used by manager

    +

    +

    @@ -1018,11 +1141,11 @@ - + - +

    n_pspecs :

    out. out. out. out.

    Returns :

    transfer full. transfer full. transfer full. transfer full.
    @@ -1031,10 +1154,14 @@

    clutter_layout_manager_begin_animation ()

    -
    ClutterAlpha *      clutter_layout_manager_begin_animation
    -                                                        (ClutterLayoutManager *manager,
    -                                                         guint duration,
    -                                                         gulong mode);
    +
    ClutterAlpha *      clutter_layout_manager_begin_animation
    +                                                        (ClutterLayoutManager *manager,
    +                                                         guint duration,
    +                                                         gulong mode);

    Begins an animation of duration milliseconds, using the provided easing mode @@ -1045,6 +1172,8 @@

    The result of this function depends on the manager implementation

    +

    +

    @@ -1065,7 +1194,7 @@ - +

    Returns :

    transfer none. transfer none. transfer none. transfer none.
    @@ -1074,13 +1203,15 @@

    clutter_layout_manager_end_animation ()

    -
    void                clutter_layout_manager_end_animation
    -                                                        (ClutterLayoutManager *manager);
    +
    void                clutter_layout_manager_end_animation
    +                                                        (ClutterLayoutManager *manager);

    Ends an animation started by clutter_layout_manager_begin_animation()

    The result of this call depends on the manager implementation

    +

    +

    @@ -1094,8 +1225,10 @@

    clutter_layout_manager_get_animation_progress ()

    -
    gdouble             clutter_layout_manager_get_animation_progress
    -                                                        (ClutterLayoutManager *manager);
    +
    gdouble             clutter_layout_manager_get_animation_progress
    +                                                        (ClutterLayoutManager *manager);

    Retrieves the progress of the animation, if one has been started by clutter_layout_manager_begin_animation() @@ -1103,6 +1236,8 @@

    The returned value has the same semantics of the "alpha" value

    +

    +

    @@ -1126,8 +1261,10 @@

    Signal Details

    The "layout-changed" signal

    -
    void                user_function                      (ClutterLayoutManager *manager,
    -                                                        gpointer              user_data)      : Run Last
    +
    void                user_function                      (ClutterLayoutManager *manager,
    +                                                        gpointer              user_data)      : Run Last

    The ::layout-changed signal is emitted each time a layout manager has been changed. Every ClutterActor using the manager instance @@ -1155,6 +1292,8 @@ can be controlled or changed using parameters should emit the ::layout-changed signal whenever one of the parameters changes, by using clutter_layout_manager_layout_changed().

    +

    +

    @@ -1169,12 +1308,12 @@
    -

    Since 1.2

    +

    Since 1.2

    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/index.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/html/index.sgml @@ -6,23 +6,16 @@ - - - - - - + + + + + + - - - - - - - - + @@ -44,8 +37,6 @@ - - @@ -383,22 +374,12 @@ - - - - - - - - + - - - @@ -599,8 +580,8 @@ - - + + @@ -611,9 +592,6 @@ - - - @@ -697,11 +675,6 @@ - - - - - @@ -718,8 +691,6 @@ - - @@ -751,9 +722,6 @@ - - - @@ -801,8 +769,6 @@ - - @@ -1014,13 +980,6 @@ - - - - - - - @@ -1061,12 +1020,7 @@ - - - - - @@ -1094,16 +1048,6 @@ - - - - - - - - - - @@ -1154,39 +1098,6 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -1259,8 +1170,6 @@ - - @@ -1297,7 +1206,7 @@ - + @@ -1327,54 +1236,14 @@ - - + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -1413,13 +1282,8 @@ - + - - - - - @@ -1437,15 +1301,10 @@ - - - - - @@ -1476,9 +1335,6 @@ - - - @@ -1495,13 +1351,13 @@ - + - + - + @@ -1536,10 +1392,6 @@ - - - - @@ -1578,11 +1430,6 @@ - - - - - @@ -1599,7 +1446,7 @@ - + @@ -1614,7 +1461,7 @@ - + @@ -1622,33 +1469,22 @@ - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + @@ -1663,9 +1499,6 @@ - - - @@ -1816,9 +1649,6 @@ - - - @@ -1866,12 +1696,11 @@ + - - + - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/pt10.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/pt10.html @@ -5,10 +5,10 @@ Part I.  - + - + @@ -54,18 +54,18 @@ - +

    -Part I. 

    This section describes the changes that need to be +Part I. 
    This section describes the changes that need to be done in applications using Clutter to use new features or to migrate from old, deprecated API to the new ones.
    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/clutter-animation-behaviours.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/clutter-animation-behaviours.html @@ -8,7 +8,7 @@ - + @@ -108,7 +108,7 @@
    The actors position between the path's end points directly correlates to the ClutterAlpha's current alpha value driving the behaviour. With the ClutterAlpha's animation mode - set to CLUTTER_LINEAR the actor will follow the path at a constant + set to CLUTTER_LINEAR the actor will follow the path at a constant velocity, but when changing to CLUTTER_EASE_SINE_IN_OUT the actor initially accelerates before quickly decelerating.
    @@ -234,6 +234,6 @@
    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/clutter-animation-timelines.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/clutter-animation-timelines.html @@ -8,7 +8,7 @@ - + @@ -62,7 +62,9 @@

    Timelines

    -

    Using g_timeout_add() to control an animation is complicated +

    Using g_timeout_add() to control an animation is complicated and does not work in concert with the rest of the operations Clutter must perform for each redraw cycle.

    For this reason, Clutter provides ClutterTimeline, a class that @@ -114,7 +116,9 @@

    Example 16. Using a Timeline to drive an animation

    Rewrite the example above with a ClutterTimeline instead of - using g_timeout_add()

    + using g_timeout_add()

     #include <clutter/clutter.h>
     
    @@ -152,6 +156,6 @@
     
    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ClutterBox.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ClutterBox.html @@ -8,7 +8,7 @@ - + @@ -62,14 +62,14 @@ Top -  |  - Description -  |  - Object Hierarchy -  |  - Implemented Interfaces -  |  - Properties +  |  + Description +  |  + Object Hierarchy +  |  + Implemented Interfaces +  |  + Properties
    @@ -83,48 +83,69 @@

    Synopsis

    -
                        ClutterBox;
    +
    +                    ClutterBox;
                         ClutterBoxClass;
    -ClutterActor *      clutter_box_new                     (ClutterLayoutManager *manager);
    -void                clutter_box_set_layout_manager      (ClutterBox *box,
    -                                                         ClutterLayoutManager *manager);
    -ClutterLayoutManager * clutter_box_get_layout_manager   (ClutterBox *box);
    -void                clutter_box_set_color               (ClutterBox *box,
    -                                                         const ClutterColor *color);
    -void                clutter_box_get_color               (ClutterBox *box,
    -                                                         ClutterColor *color);
    +ClutterActor *      clutter_box_new                     (ClutterLayoutManager *manager);
    +void                clutter_box_set_layout_manager      (ClutterBox *box,
    +                                                         ClutterLayoutManager *manager);
    +ClutterLayoutManager * clutter_box_get_layout_manager   (ClutterBox *box);
    +void                clutter_box_set_color               (ClutterBox *box,
    +                                                         const ClutterColor *color);
    +void                clutter_box_get_color               (ClutterBox *box,
    +                                                         ClutterColor *color);
     
    -void                clutter_box_pack                    (ClutterBox *box,
    -                                                         ClutterActor *actor,
    -                                                         const gchar *first_property,
    +void                clutter_box_pack                    (ClutterBox *box,
    +                                                         ClutterActor *actor,
    +                                                         const gchar *first_property,
                                                              ...);
    -void                clutter_box_packv                   (ClutterBox *box,
    -                                                         ClutterActor *actor,
    -                                                         guint n_properties,
    -                                                         const gchar * const properties[],
    -                                                         const GValue *values);
    -void                clutter_box_pack_after              (ClutterBox *box,
    -                                                         ClutterActor *actor,
    -                                                         ClutterActor *sibling,
    -                                                         const gchar *first_property,
    +void                clutter_box_packv                   (ClutterBox *box,
    +                                                         ClutterActor *actor,
    +                                                         guint n_properties,
    +                                                         const gchar * const properties[],
    +                                                         const GValue *values);
    +void                clutter_box_pack_after              (ClutterBox *box,
    +                                                         ClutterActor *actor,
    +                                                         ClutterActor *sibling,
    +                                                         const gchar *first_property,
                                                              ...);
    -void                clutter_box_pack_before             (ClutterBox *box,
    -                                                         ClutterActor *actor,
    -                                                         ClutterActor *sibling,
    -                                                         const gchar *first_property,
    +void                clutter_box_pack_before             (ClutterBox *box,
    +                                                         ClutterActor *actor,
    +                                                         ClutterActor *sibling,
    +                                                         const gchar *first_property,
                                                              ...);
    -void                clutter_box_pack_at                 (ClutterBox *box,
    -                                                         ClutterActor *actor,
    -                                                         gint position,
    -                                                         const gchar *first_property,
    +void                clutter_box_pack_at                 (ClutterBox *box,
    +                                                         ClutterActor *actor,
    +                                                         gint position,
    +                                                         const gchar *first_property,
                                                              ...);
     

    Object Hierarchy

    -  GObject
    -   +----GInitiallyUnowned
    +  GObject
    +   +----GInitiallyUnowned
              +----ClutterActor
                    +----ClutterBox
     
    @@ -138,9 +159,11 @@

    Properties

    -  "color"                    ClutterColor*         : Read / Write
    -  "color-set"                gboolean              : Read / Write
    -  "layout-manager"           ClutterLayoutManager*  : Read / Write / Construct
    +  "color"                    ClutterColor*         : Read / Write
    +  "color-set"                gboolean              : Read / Write
    +  "layout-manager"           ClutterLayoutManager*  : Read / Write / Construct
     
    @@ -193,6 +216,8 @@

    ClutterBox is available since Clutter 1.2

    +

    +

    Details

    @@ -202,6 +227,8 @@

    The ClutterBox structure contains only private data and should be accessed using the provided API

    +

    +

    Since 1.2


    @@ -212,15 +239,19 @@

    The ClutterBoxClass structure contains only private data

    +

    +

    Since 1.2


    clutter_box_new ()

    -
    ClutterActor *      clutter_box_new                     (ClutterLayoutManager *manager);
    +
    ClutterActor *      clutter_box_new                     (ClutterLayoutManager *manager);

    Creates a new ClutterBox. The children of the box will be layed out by the passed manager

    +

    +

    @@ -242,14 +273,16 @@

    clutter_box_set_layout_manager ()

    -
    void                clutter_box_set_layout_manager      (ClutterBox *box,
    -                                                         ClutterLayoutManager *manager);
    +
    void                clutter_box_set_layout_manager      (ClutterBox *box,
    +                                                         ClutterLayoutManager *manager);

    Sets the ClutterLayoutManager for box

    A ClutterLayoutManager is a delegate object that controls the layout of the children of box

    +

    +

    @@ -270,9 +303,11 @@

    clutter_box_get_layout_manager ()

    -
    ClutterLayoutManager * clutter_box_get_layout_manager   (ClutterBox *box);
    +
    ClutterLayoutManager * clutter_box_get_layout_manager   (ClutterBox *box);

    Retrieves the ClutterLayoutManager instance used by box

    +

    +

    @@ -294,10 +329,12 @@

    clutter_box_set_color ()

    -
    void                clutter_box_set_color               (ClutterBox *box,
    -                                                         const ClutterColor *color);
    +
    void                clutter_box_set_color               (ClutterBox *box,
    +                                                         const ClutterColor *color);

    Sets (or unsets) the background color for box

    +

    +

    @@ -308,7 +345,7 @@ - +

    color :

    the background color, or NULL to unset. allow-none. the background color, or NULL to unset. allow-none.
    @@ -317,14 +354,16 @@

    clutter_box_get_color ()

    -
    void                clutter_box_get_color               (ClutterBox *box,
    -                                                         ClutterColor *color);
    +
    void                clutter_box_get_color               (ClutterBox *box,
    +                                                         ClutterColor *color);

    Retrieves the background color of box

    -If the "color-set" property is set to FALSE the +If the "color-set" property is set to FALSE the returned ClutterColor is undefined

    +

    +

    @@ -335,7 +374,7 @@ - +

    color :

    return location for a ClutterColor. out. return location for a ClutterColor. out.
    @@ -344,9 +383,11 @@

    clutter_box_pack ()

    -
    void                clutter_box_pack                    (ClutterBox *box,
    -                                                         ClutterActor *actor,
    -                                                         const gchar *first_property,
    +
    void                clutter_box_pack                    (ClutterBox *box,
    +                                                         ClutterActor *actor,
    +                                                         const gchar *first_property,
                                                              ...);

    Adds actor to box and sets layout properties at the same time, @@ -359,6 +400,8 @@

    Language bindings should use the vector-based clutter_box_addv() variant instead

    +

    +

    @@ -374,12 +417,12 @@ - - @@ -389,14 +432,22 @@

    clutter_box_packv ()

    -
    void                clutter_box_packv                   (ClutterBox *box,
    -                                                         ClutterActor *actor,
    -                                                         guint n_properties,
    -                                                         const gchar * const properties[],
    -                                                         const GValue *values);
    +
    void                clutter_box_packv                   (ClutterBox *box,
    +                                                         ClutterActor *actor,
    +                                                         guint n_properties,
    +                                                         const gchar * const properties[],
    +                                                         const GValue *values);

    Vector-based variant of clutter_box_pack(), intended for language bindings to use

    +

    +

    first_property :

    the name of the first property to set, or NULL + the name of the first property to set, or NULL

    ... :

    a list of property name and value pairs, terminated by NULL + a list of property name and value pairs, terminated by NULL
    @@ -430,10 +481,12 @@

    clutter_box_pack_after ()

    -
    void                clutter_box_pack_after              (ClutterBox *box,
    -                                                         ClutterActor *actor,
    -                                                         ClutterActor *sibling,
    -                                                         const gchar *first_property,
    +
    void                clutter_box_pack_after              (ClutterBox *box,
    +                                                         ClutterActor *actor,
    +                                                         ClutterActor *sibling,
    +                                                         const gchar *first_property,
                                                              ...);

    Adds actor to box, placing it after sibling, and sets layout @@ -441,12 +494,14 @@ box supports them

    -If sibling is NULL then actor is placed at the end of the +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()

    +

    +

    @@ -462,16 +517,16 @@ - + - - @@ -481,10 +536,12 @@

    clutter_box_pack_before ()

    -
    void                clutter_box_pack_before             (ClutterBox *box,
    -                                                         ClutterActor *actor,
    -                                                         ClutterActor *sibling,
    -                                                         const gchar *first_property,
    +
    void                clutter_box_pack_before             (ClutterBox *box,
    +                                                         ClutterActor *actor,
    +                                                         ClutterActor *sibling,
    +                                                         const gchar *first_property,
                                                              ...);

    Adds actor to box, placing it before sibling, and sets layout @@ -492,12 +549,14 @@ box supports them

    -If sibling is NULL then actor is placed at the beginning of the +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()

    +

    +

    sibling :

    a ClutterActor or NULL. allow-none. a ClutterActor or NULL. allow-none.

    first_property :

    the name of the first property to set, or NULL + the name of the first property to set, or NULL

    ... :

    a list of property name and value pairs, terminated by NULL + a list of property name and value pairs, terminated by NULL
    @@ -513,16 +572,16 @@ - + - - @@ -532,10 +591,14 @@

    clutter_box_pack_at ()

    -
    void                clutter_box_pack_at                 (ClutterBox *box,
    -                                                         ClutterActor *actor,
    -                                                         gint position,
    -                                                         const gchar *first_property,
    +
    void                clutter_box_pack_at                 (ClutterBox *box,
    +                                                         ClutterActor *actor,
    +                                                         gint position,
    +                                                         const gchar *first_property,
                                                              ...);

    Adds actor to box, placing it at position, and sets layout @@ -546,6 +609,8 @@ 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

    +

    +

    sibling :

    a ClutterActor or NULL. allow-none. a ClutterActor or NULL. allow-none.

    first_property :

    the name of the first property to set, or NULL + the name of the first property to set, or NULL

    ... :

    a list of property name and value pairs, terminated by NULL + a list of property name and value pairs, terminated by NULL
    @@ -566,12 +631,12 @@ - - @@ -583,34 +648,42 @@

    Property Details

    The "color" property

    -
      "color"                    ClutterColor*         : Read / Write
    +
      "color"                    ClutterColor*         : Read / Write

    The color to be used to paint the background of the ClutterBox. Setting this property will set the "color-set" property as a side effect

    -

    Since 1.2

    +

    +

    +

    Since 1.2


    The "color-set" property

    -
      "color-set"                gboolean              : Read / Write
    +
      "color-set"                gboolean              : Read / Write

    Whether the "color" property has been set

    +

    +

    Default value: FALSE

    -

    Since 1.2

    +

    Since 1.2


    The "layout-manager" property

    -
      "layout-manager"           ClutterLayoutManager*  : Read / Write / Construct
    +
      "layout-manager"           ClutterLayoutManager*  : Read / Write / Construct

    The ClutterLayoutManager used by the ClutterBox

    -

    Since 1.2

    +

    +

    +

    Since 1.2

    + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ClutterActor.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ClutterActor.html @@ -8,7 +8,7 @@ - + @@ -62,16 +62,16 @@

    first_property :

    the name of the first property to set, or NULL + the name of the first property to set, or NULL

    ... :

    a list of property name and value pairs, terminated by NULL + a list of property name and value pairs, terminated by NULL
    Top -  |  - Description -  |  - Object Hierarchy -  |  - Implemented Interfaces -  |  - Properties -  |  - Signals +  |  + Description +  |  + Object Hierarchy +  |  + Implemented Interfaces +  |  + Properties +  |  + Signals
    @@ -85,321 +85,590 @@

    Synopsis

    -
    #define             CLUTTER_ACTOR_SET_FLAGS             (a,f)
    -#define             CLUTTER_ACTOR_UNSET_FLAGS           (a,f)
    -#define             CLUTTER_ACTOR_IS_MAPPED             (a)
    -#define             CLUTTER_ACTOR_IS_REALIZED           (a)
    -#define             CLUTTER_ACTOR_IS_VISIBLE            (a)
    -#define             CLUTTER_ACTOR_IS_REACTIVE           (a)
    +
    +#define             CLUTTER_ACTOR_SET_FLAGS             (a,f)
    +#define             CLUTTER_ACTOR_UNSET_FLAGS           (a,f)
    +#define             CLUTTER_ACTOR_IS_MAPPED             (a)
    +#define             CLUTTER_ACTOR_IS_REALIZED           (a)
    +#define             CLUTTER_ACTOR_IS_VISIBLE            (a)
    +#define             CLUTTER_ACTOR_IS_REACTIVE           (a)
     
     enum                ClutterActorFlags;
     enum                ClutterRequestMode;
                         ClutterGeometry;
    -#define             CLUTTER_CALLBACK                    (f)
    -void                (*ClutterCallback)                  (ClutterActor *actor,
    -                                                         gpointer data);
    +#define             CLUTTER_CALLBACK                    (f)
    +void                (*ClutterCallback)                  (ClutterActor *actor,
    +                                                         gpointer data);
                         ClutterActor;
                         ClutterActorClass;
    -void                clutter_actor_set_flags             (ClutterActor *self,
    -                                                         ClutterActorFlags flags);
    -void                clutter_actor_unset_flags           (ClutterActor *self,
    -                                                         ClutterActorFlags flags);
    -ClutterActorFlags   clutter_actor_get_flags             (ClutterActor *self);
    -
    -void                clutter_actor_show                  (ClutterActor *self);
    -void                clutter_actor_show_all              (ClutterActor *self);
    -void                clutter_actor_hide                  (ClutterActor *self);
    -void                clutter_actor_hide_all              (ClutterActor *self);
    -void                clutter_actor_realize               (ClutterActor *self);
    -void                clutter_actor_unrealize             (ClutterActor *self);
    -void                clutter_actor_paint                 (ClutterActor *self);
    -void                clutter_actor_queue_redraw          (ClutterActor *self);
    -void                clutter_actor_queue_relayout        (ClutterActor *self);
    -void                clutter_actor_destroy               (ClutterActor *self);
    -gboolean            clutter_actor_event                 (ClutterActor *actor,
    -                                                         ClutterEvent *event,
    -                                                         gboolean capture);
    -gboolean            clutter_actor_should_pick_paint     (ClutterActor *self);
    -void                clutter_actor_map                   (ClutterActor *self);
    -void                clutter_actor_unmap                 (ClutterActor *self);
    +void                clutter_actor_set_flags             (ClutterActor *self,
    +                                                         ClutterActorFlags flags);
    +void                clutter_actor_unset_flags           (ClutterActor *self,
    +                                                         ClutterActorFlags flags);
    +ClutterActorFlags   clutter_actor_get_flags             (ClutterActor *self);
    +
    +void                clutter_actor_show                  (ClutterActor *self);
    +void                clutter_actor_show_all              (ClutterActor *self);
    +void                clutter_actor_hide                  (ClutterActor *self);
    +void                clutter_actor_hide_all              (ClutterActor *self);
    +void                clutter_actor_realize               (ClutterActor *self);
    +void                clutter_actor_unrealize             (ClutterActor *self);
    +void                clutter_actor_paint                 (ClutterActor *self);
    +void                clutter_actor_queue_redraw          (ClutterActor *self);
    +void                clutter_actor_queue_relayout        (ClutterActor *self);
    +void                clutter_actor_destroy               (ClutterActor *self);
    +gboolean            clutter_actor_event                 (ClutterActor *actor,
    +                                                         ClutterEvent *event,
    +                                                         gboolean capture);
    +gboolean            clutter_actor_should_pick_paint     (ClutterActor *self);
    +void                clutter_actor_map                   (ClutterActor *self);
    +void                clutter_actor_unmap                 (ClutterActor *self);
     
     enum                ClutterAllocationFlags;
    -void                clutter_actor_allocate              (ClutterActor *self,
    -                                                         const ClutterActorBox *box,
    -                                                         ClutterAllocationFlags flags);
    -void                clutter_actor_allocate_preferred_size
    -                                                        (ClutterActor *self,
    -                                                         ClutterAllocationFlags flags);
    -void                clutter_actor_allocate_available_size
    -                                                        (ClutterActor *self,
    -                                                         gfloat x,
    -                                                         gfloat y,
    -                                                         gfloat available_width,
    -                                                         gfloat available_height,
    -                                                         ClutterAllocationFlags flags);
    -void                clutter_actor_get_allocation_box    (ClutterActor *self,
    -                                                         ClutterActorBox *box);
    -void                clutter_actor_get_allocation_geometry
    -                                                        (ClutterActor *self,
    -                                                         ClutterGeometry *geom);
    -void                clutter_actor_get_allocation_vertices
    -                                                        (ClutterActor *self,
    -                                                         ClutterActor *ancestor,
    -                                                         ClutterVertex verts[]);
    -void                clutter_actor_get_preferred_size    (ClutterActor *self,
    -                                                         gfloat *min_width_p,
    -                                                         gfloat *min_height_p,
    -                                                         gfloat *natural_width_p,
    -                                                         gfloat *natural_height_p);
    -void                clutter_actor_get_preferred_width   (ClutterActor *self,
    -                                                         gfloat for_height,
    -                                                         gfloat *min_width_p,
    -                                                         gfloat *natural_width_p);
    -void                clutter_actor_get_preferred_height  (ClutterActor *self,
    -                                                         gfloat for_width,
    -                                                         gfloat *min_height_p,
    -                                                         gfloat *natural_height_p);
    -void                clutter_actor_set_fixed_position_set
    -                                                        (ClutterActor *self,
    -                                                         gboolean is_set);
    -gboolean            clutter_actor_get_fixed_position_set
    -                                                        (ClutterActor *self);
    -void                clutter_actor_set_request_mode      (ClutterActor *self,
    -                                                         ClutterRequestMode mode);
    -ClutterRequestMode  clutter_actor_get_request_mode      (ClutterActor *self);
    -
    -void                clutter_actor_set_geometry          (ClutterActor *self,
    -                                                         const ClutterGeometry *geometry);
    -void                clutter_actor_get_geometry          (ClutterActor *self,
    -                                                         ClutterGeometry *geometry);
    -void                clutter_actor_set_size              (ClutterActor *self,
    -                                                         gfloat width,
    -                                                         gfloat height);
    -void                clutter_actor_get_size              (ClutterActor *self,
    -                                                         gfloat *width,
    -                                                         gfloat *height);
    -void                clutter_actor_set_position          (ClutterActor *self,
    -                                                         gfloat x,
    -                                                         gfloat y);
    -void                clutter_actor_get_position          (ClutterActor *self,
    -                                                         gfloat *x,
    -                                                         gfloat *y);
    -void                clutter_actor_set_width             (ClutterActor *self,
    -                                                         gfloat width);
    -gfloat              clutter_actor_get_width             (ClutterActor *self);
    -void                clutter_actor_set_height            (ClutterActor *self,
    -                                                         gfloat height);
    -gfloat              clutter_actor_get_height            (ClutterActor *self);
    -void                clutter_actor_set_x                 (ClutterActor *self,
    -                                                         gfloat x);
    -gfloat              clutter_actor_get_x                 (ClutterActor *self);
    -void                clutter_actor_set_y                 (ClutterActor *self,
    -                                                         gfloat y);
    -gfloat              clutter_actor_get_y                 (ClutterActor *self);
    -void                clutter_actor_move_by               (ClutterActor *self,
    -                                                         gfloat dx,
    -                                                         gfloat dy);
    -void                clutter_actor_set_rotation          (ClutterActor *self,
    -                                                         ClutterRotateAxis axis,
    -                                                         gdouble angle,
    -                                                         gfloat x,
    -                                                         gfloat y,
    -                                                         gfloat z);
    -void                clutter_actor_set_z_rotation_from_gravity
    -                                                        (ClutterActor *self,
    -                                                         gdouble angle,
    -                                                         ClutterGravity gravity);
    -gdouble             clutter_actor_get_rotation          (ClutterActor *self,
    -                                                         ClutterRotateAxis axis,
    -                                                         gfloat *x,
    -                                                         gfloat *y,
    -                                                         gfloat *z);
    -ClutterGravity      clutter_actor_get_z_rotation_gravity
    -                                                        (ClutterActor *self);
    -gboolean            clutter_actor_is_rotated            (ClutterActor *self);
    -void                clutter_actor_set_opacity           (ClutterActor *self,
    -                                                         guint8 opacity);
    -guint8              clutter_actor_get_opacity           (ClutterActor *self);
    -void                clutter_actor_set_name              (ClutterActor *self,
    -                                                         const gchar *name);
    -const gchar *       clutter_actor_get_name              (ClutterActor *self);
    -guint32             clutter_actor_get_gid               (ClutterActor *self);
    -
    -void                clutter_actor_set_clip              (ClutterActor *self,
    -                                                         gfloat xoff,
    -                                                         gfloat yoff,
    -                                                         gfloat width,
    -                                                         gfloat height);
    -void                clutter_actor_remove_clip           (ClutterActor *self);
    -gboolean            clutter_actor_has_clip              (ClutterActor *self);
    -void                clutter_actor_get_clip              (ClutterActor *self,
    -                                                         gfloat *xoff,
    -                                                         gfloat *yoff,
    -                                                         gfloat *width,
    -                                                         gfloat *height);
    -
    -void                clutter_actor_set_parent            (ClutterActor *self,
    -                                                         ClutterActor *parent);
    -ClutterActor *      clutter_actor_get_parent            (ClutterActor *self);
    -void                clutter_actor_reparent              (ClutterActor *self,
    -                                                         ClutterActor *new_parent);
    -void                clutter_actor_unparent              (ClutterActor *self);
    -void                clutter_actor_raise                 (ClutterActor *self,
    -                                                         ClutterActor *below);
    -void                clutter_actor_lower                 (ClutterActor *self,
    -                                                         ClutterActor *above);
    -void                clutter_actor_raise_top             (ClutterActor *self);
    -void                clutter_actor_lower_bottom          (ClutterActor *self);
    -ClutterActor*       clutter_actor_get_stage             (ClutterActor *actor);
    -void                clutter_actor_push_internal         (ClutterActor *self);
    -void                clutter_actor_pop_internal          (ClutterActor *self);
    -
    -void                clutter_actor_set_depth             (ClutterActor *self,
    -                                                         gfloat depth);
    -gfloat              clutter_actor_get_depth             (ClutterActor *self);
    -void                clutter_actor_set_scale             (ClutterActor *self,
    -                                                         gdouble scale_x,
    -                                                         gdouble scale_y);
    -void                clutter_actor_set_scale_full        (ClutterActor *self,
    -                                                         gdouble scale_x,
    -                                                         gdouble scale_y,
    -                                                         gfloat center_x,
    -                                                         gfloat center_y);
    -void                clutter_actor_set_scale_with_gravity
    -                                                        (ClutterActor *self,
    -                                                         gdouble scale_x,
    -                                                         gdouble scale_y,
    -                                                         ClutterGravity gravity);
    -void                clutter_actor_get_scale             (ClutterActor *self,
    -                                                         gdouble *scale_x,
    -                                                         gdouble *scale_y);
    -void                clutter_actor_get_scale_center      (ClutterActor *self,
    -                                                         gfloat *center_x,
    -                                                         gfloat *center_y);
    -ClutterGravity      clutter_actor_get_scale_gravity     (ClutterActor *self);
    -gboolean            clutter_actor_is_scaled             (ClutterActor *self);
    -void                clutter_actor_apply_transform_to_point
    -                                                        (ClutterActor *self,
    -                                                         const ClutterVertex *point,
    -                                                         ClutterVertex *vertex);
    -gboolean            clutter_actor_transform_stage_point (ClutterActor *self,
    -                                                         gfloat x,
    -                                                         gfloat y,
    -                                                         gfloat *x_out,
    -                                                         gfloat *y_out);
    -void                clutter_actor_apply_relative_transform_to_point
    -                                                        (ClutterActor *self,
    -                                                         ClutterActor *ancestor,
    -                                                         const ClutterVertex *point,
    -                                                         ClutterVertex *vertex);
    -void                clutter_actor_get_transformed_position
    -                                                        (ClutterActor *self,
    -                                                         gfloat *x,
    -                                                         gfloat *y);
    -void                clutter_actor_get_transformed_size  (ClutterActor *self,
    -                                                         gfloat *width,
    -                                                         gfloat *height);
    -guint8              clutter_actor_get_paint_opacity     (ClutterActor *self);
    -gboolean            clutter_actor_get_paint_visibility  (ClutterActor *self);
    -void                clutter_actor_get_abs_allocation_vertices
    -                                                        (ClutterActor *self,
    -                                                         ClutterVertex verts[]);
    -void                clutter_actor_get_transformation_matrix
    -                                                        (ClutterActor *self,
    -                                                         CoglMatrix *matrix);
    -
    -void                clutter_actor_set_anchor_point      (ClutterActor *self,
    -                                                         gfloat anchor_x,
    -                                                         gfloat anchor_y);
    -void                clutter_actor_get_anchor_point      (ClutterActor *self,
    -                                                         gfloat *anchor_x,
    -                                                         gfloat *anchor_y);
    -void                clutter_actor_set_anchor_point_from_gravity
    -                                                        (ClutterActor *self,
    -                                                         ClutterGravity gravity);
    -ClutterGravity      clutter_actor_get_anchor_point_gravity
    -                                                        (ClutterActor *self);
    -void                clutter_actor_move_anchor_point     (ClutterActor *self,
    -                                                         gfloat anchor_x,
    -                                                         gfloat anchor_y);
    -void                clutter_actor_move_anchor_point_from_gravity
    -                                                        (ClutterActor *self,
    -                                                         ClutterGravity gravity);
    -
    -void                clutter_actor_set_reactive          (ClutterActor *actor,
    -                                                         gboolean reactive);
    -gboolean            clutter_actor_get_reactive          (ClutterActor *actor);
    -gboolean            clutter_actor_set_shader            (ClutterActor *self,
    -                                                         ClutterShader *shader);
    -ClutterShader *     clutter_actor_get_shader            (ClutterActor *self);
    -void                clutter_actor_set_shader_param      (ClutterActor *self,
    -                                                         const gchar *param,
    -                                                         const GValue *value);
    -void                clutter_actor_set_shader_param_float
    -                                                        (ClutterActor *self,
    -                                                         const gchar *param,
    -                                                         gfloat value);
    -void                clutter_actor_set_shader_param_int  (ClutterActor *self,
    -                                                         const gchar *param,
    -                                                         gint value);
    -
    -void                clutter_actor_grab_key_focus        (ClutterActor *self);
    -PangoContext *      clutter_actor_get_pango_context     (ClutterActor *self);
    -PangoContext *      clutter_actor_create_pango_context  (ClutterActor *self);
    -PangoLayout *       clutter_actor_create_pango_layout   (ClutterActor *self,
    -                                                         const gchar *text);
    -gboolean            clutter_actor_is_in_clone_paint     (ClutterActor *self);
    -void                clutter_actor_set_text_direction    (ClutterActor *self,
    -                                                         ClutterTextDirection text_dir);
    -ClutterTextDirection  clutter_actor_get_text_direction  (ClutterActor *self);
    -gboolean            clutter_actor_has_pointer           (ClutterActor *self);
    +void                clutter_actor_allocate              (ClutterActor *self,
    +                                                         const ClutterActorBox *box,
    +                                                         ClutterAllocationFlags flags);
    +void                clutter_actor_allocate_preferred_size
    +                                                        (ClutterActor *self,
    +                                                         ClutterAllocationFlags flags);
    +void                clutter_actor_allocate_available_size
    +                                                        (ClutterActor *self,
    +                                                         gfloat x,
    +                                                         gfloat y,
    +                                                         gfloat available_width,
    +                                                         gfloat available_height,
    +                                                         ClutterAllocationFlags flags);
    +void                clutter_actor_get_allocation_box    (ClutterActor *self,
    +                                                         ClutterActorBox *box);
    +void                clutter_actor_get_allocation_geometry
    +                                                        (ClutterActor *self,
    +                                                         ClutterGeometry *geom);
    +void                clutter_actor_get_allocation_vertices
    +                                                        (ClutterActor *self,
    +                                                         ClutterActor *ancestor,
    +                                                         ClutterVertex verts[]);
    +void                clutter_actor_get_preferred_size    (ClutterActor *self,
    +                                                         gfloat *min_width_p,
    +                                                         gfloat *min_height_p,
    +                                                         gfloat *natural_width_p,
    +                                                         gfloat *natural_height_p);
    +void                clutter_actor_get_preferred_width   (ClutterActor *self,
    +                                                         gfloat for_height,
    +                                                         gfloat *min_width_p,
    +                                                         gfloat *natural_width_p);
    +void                clutter_actor_get_preferred_height  (ClutterActor *self,
    +                                                         gfloat for_width,
    +                                                         gfloat *min_height_p,
    +                                                         gfloat *natural_height_p);
    +void                clutter_actor_set_fixed_position_set
    +                                                        (ClutterActor *self,
    +                                                         gboolean is_set);
    +gboolean            clutter_actor_get_fixed_position_set
    +                                                        (ClutterActor *self);
    +void                clutter_actor_set_request_mode      (ClutterActor *self,
    +                                                         ClutterRequestMode mode);
    +ClutterRequestMode  clutter_actor_get_request_mode      (ClutterActor *self);
    +
    +void                clutter_actor_set_geometry          (ClutterActor *self,
    +                                                         const ClutterGeometry *geometry);
    +void                clutter_actor_get_geometry          (ClutterActor *self,
    +                                                         ClutterGeometry *geometry);
    +void                clutter_actor_set_size              (ClutterActor *self,
    +                                                         gfloat width,
    +                                                         gfloat height);
    +void                clutter_actor_get_size              (ClutterActor *self,
    +                                                         gfloat *width,
    +                                                         gfloat *height);
    +void                clutter_actor_set_position          (ClutterActor *self,
    +                                                         gfloat x,
    +                                                         gfloat y);
    +void                clutter_actor_get_position          (ClutterActor *self,
    +                                                         gfloat *x,
    +                                                         gfloat *y);
    +void                clutter_actor_set_width             (ClutterActor *self,
    +                                                         gfloat width);
    +gfloat              clutter_actor_get_width             (ClutterActor *self);
    +void                clutter_actor_set_height            (ClutterActor *self,
    +                                                         gfloat height);
    +gfloat              clutter_actor_get_height            (ClutterActor *self);
    +void                clutter_actor_set_x                 (ClutterActor *self,
    +                                                         gfloat x);
    +gfloat              clutter_actor_get_x                 (ClutterActor *self);
    +void                clutter_actor_set_y                 (ClutterActor *self,
    +                                                         gfloat y);
    +gfloat              clutter_actor_get_y                 (ClutterActor *self);
    +void                clutter_actor_move_by               (ClutterActor *self,
    +                                                         gfloat dx,
    +                                                         gfloat dy);
    +void                clutter_actor_set_rotation          (ClutterActor *self,
    +                                                         ClutterRotateAxis axis,
    +                                                         gdouble angle,
    +                                                         gfloat x,
    +                                                         gfloat y,
    +                                                         gfloat z);
    +void                clutter_actor_set_z_rotation_from_gravity
    +                                                        (ClutterActor *self,
    +                                                         gdouble angle,
    +                                                         ClutterGravity gravity);
    +gdouble             clutter_actor_get_rotation          (ClutterActor *self,
    +                                                         ClutterRotateAxis axis,
    +                                                         gfloat *x,
    +                                                         gfloat *y,
    +                                                         gfloat *z);
    +ClutterGravity      clutter_actor_get_z_rotation_gravity
    +                                                        (ClutterActor *self);
    +gboolean            clutter_actor_is_rotated            (ClutterActor *self);
    +void                clutter_actor_set_opacity           (ClutterActor *self,
    +                                                         guint8 opacity);
    +guint8              clutter_actor_get_opacity           (ClutterActor *self);
    +void                clutter_actor_set_name              (ClutterActor *self,
    +                                                         const gchar *name);
    +const gchar *       clutter_actor_get_name              (ClutterActor *self);
    +guint32             clutter_actor_get_gid               (ClutterActor *self);
    +
    +void                clutter_actor_set_clip              (ClutterActor *self,
    +                                                         gfloat xoff,
    +                                                         gfloat yoff,
    +                                                         gfloat width,
    +                                                         gfloat height);
    +void                clutter_actor_remove_clip           (ClutterActor *self);
    +gboolean            clutter_actor_has_clip              (ClutterActor *self);
    +void                clutter_actor_get_clip              (ClutterActor *self,
    +                                                         gfloat *xoff,
    +                                                         gfloat *yoff,
    +                                                         gfloat *width,
    +                                                         gfloat *height);
    +
    +void                clutter_actor_set_parent            (ClutterActor *self,
    +                                                         ClutterActor *parent);
    +ClutterActor *      clutter_actor_get_parent            (ClutterActor *self);
    +void                clutter_actor_reparent              (ClutterActor *self,
    +                                                         ClutterActor *new_parent);
    +void                clutter_actor_unparent              (ClutterActor *self);
    +void                clutter_actor_raise                 (ClutterActor *self,
    +                                                         ClutterActor *below);
    +void                clutter_actor_lower                 (ClutterActor *self,
    +                                                         ClutterActor *above);
    +void                clutter_actor_raise_top             (ClutterActor *self);
    +void                clutter_actor_lower_bottom          (ClutterActor *self);
    +ClutterActor*       clutter_actor_get_stage             (ClutterActor *actor);
    +void                clutter_actor_push_internal         (ClutterActor *self);
    +void                clutter_actor_pop_internal          (ClutterActor *self);
    +
    +void                clutter_actor_set_depth             (ClutterActor *self,
    +                                                         gfloat depth);
    +gfloat              clutter_actor_get_depth             (ClutterActor *self);
    +void                clutter_actor_set_scale             (ClutterActor *self,
    +                                                         gdouble scale_x,
    +                                                         gdouble scale_y);
    +void                clutter_actor_set_scale_full        (ClutterActor *self,
    +                                                         gdouble scale_x,
    +                                                         gdouble scale_y,
    +                                                         gfloat center_x,
    +                                                         gfloat center_y);
    +void                clutter_actor_set_scale_with_gravity
    +                                                        (ClutterActor *self,
    +                                                         gdouble scale_x,
    +                                                         gdouble scale_y,
    +                                                         ClutterGravity gravity);
    +void                clutter_actor_get_scale             (ClutterActor *self,
    +                                                         gdouble *scale_x,
    +                                                         gdouble *scale_y);
    +void                clutter_actor_get_scale_center      (ClutterActor *self,
    +                                                         gfloat *center_x,
    +                                                         gfloat *center_y);
    +ClutterGravity      clutter_actor_get_scale_gravity     (ClutterActor *self);
    +gboolean            clutter_actor_is_scaled             (ClutterActor *self);
    +void                clutter_actor_apply_transform_to_point
    +                                                        (ClutterActor *self,
    +                                                         const ClutterVertex *point,
    +                                                         ClutterVertex *vertex);
    +gboolean            clutter_actor_transform_stage_point (ClutterActor *self,
    +                                                         gfloat x,
    +                                                         gfloat y,
    +                                                         gfloat *x_out,
    +                                                         gfloat *y_out);
    +void                clutter_actor_apply_relative_transform_to_point
    +                                                        (ClutterActor *self,
    +                                                         ClutterActor *ancestor,
    +                                                         const ClutterVertex *point,
    +                                                         ClutterVertex *vertex);
    +void                clutter_actor_get_transformed_position
    +                                                        (ClutterActor *self,
    +                                                         gfloat *x,
    +                                                         gfloat *y);
    +void                clutter_actor_get_transformed_size  (ClutterActor *self,
    +                                                         gfloat *width,
    +                                                         gfloat *height);
    +guint8              clutter_actor_get_paint_opacity     (ClutterActor *self);
    +gboolean            clutter_actor_get_paint_visibility  (ClutterActor *self);
    +void                clutter_actor_get_abs_allocation_vertices
    +                                                        (ClutterActor *self,
    +                                                         ClutterVertex verts[]);
    +void                clutter_actor_get_transformation_matrix
    +                                                        (ClutterActor *self,
    +                                                         CoglMatrix *matrix);
    +
    +void                clutter_actor_set_anchor_point      (ClutterActor *self,
    +                                                         gfloat anchor_x,
    +                                                         gfloat anchor_y);
    +void                clutter_actor_get_anchor_point      (ClutterActor *self,
    +                                                         gfloat *anchor_x,
    +                                                         gfloat *anchor_y);
    +void                clutter_actor_set_anchor_point_from_gravity
    +                                                        (ClutterActor *self,
    +                                                         ClutterGravity gravity);
    +ClutterGravity      clutter_actor_get_anchor_point_gravity
    +                                                        (ClutterActor *self);
    +void                clutter_actor_move_anchor_point     (ClutterActor *self,
    +                                                         gfloat anchor_x,
    +                                                         gfloat anchor_y);
    +void                clutter_actor_move_anchor_point_from_gravity
    +                                                        (ClutterActor *self,
    +                                                         ClutterGravity gravity);
    +
    +void                clutter_actor_set_reactive          (ClutterActor *actor,
    +                                                         gboolean reactive);
    +gboolean            clutter_actor_get_reactive          (ClutterActor *actor);
    +gboolean            clutter_actor_set_shader            (ClutterActor *self,
    +                                                         ClutterShader *shader);
    +ClutterShader *     clutter_actor_get_shader            (ClutterActor *self);
    +void                clutter_actor_set_shader_param      (ClutterActor *self,
    +                                                         const gchar *param,
    +                                                         const GValue *value);
    +void                clutter_actor_set_shader_param_float
    +                                                        (ClutterActor *self,
    +                                                         const gchar *param,
    +                                                         gfloat value);
    +void                clutter_actor_set_shader_param_int  (ClutterActor *self,
    +                                                         const gchar *param,
    +                                                         gint value);
    +
    +void                clutter_actor_grab_key_focus        (ClutterActor *self);
    +PangoContext *      clutter_actor_get_pango_context     (ClutterActor *self);
    +PangoContext *      clutter_actor_create_pango_context  (ClutterActor *self);
    +PangoLayout *       clutter_actor_create_pango_layout   (ClutterActor *self,
    +                                                         const gchar *text);
    +gboolean            clutter_actor_is_in_clone_paint     (ClutterActor *self);
    +void                clutter_actor_set_text_direction    (ClutterActor *self,
    +                                                         ClutterTextDirection text_dir);
    +ClutterTextDirection  clutter_actor_get_text_direction  (ClutterActor *self);
    +gboolean            clutter_actor_has_pointer           (ClutterActor *self);
     
                         ClutterActorBox;
    -ClutterActorBox *   clutter_actor_box_new               (gfloat x_1,
    -                                                         gfloat y_1,
    -                                                         gfloat x_2,
    -                                                         gfloat y_2);
    -ClutterActorBox *   clutter_actor_box_copy              (const ClutterActorBox *box);
    -void                clutter_actor_box_free              (ClutterActorBox *box);
    -gboolean            clutter_actor_box_equal             (const ClutterActorBox *box_a,
    -                                                         const ClutterActorBox *box_b);
    -gfloat              clutter_actor_box_get_x             (const ClutterActorBox *box);
    -gfloat              clutter_actor_box_get_y             (const ClutterActorBox *box);
    -gfloat              clutter_actor_box_get_width         (const ClutterActorBox *box);
    -gfloat              clutter_actor_box_get_height        (const ClutterActorBox *box);
    -void                clutter_actor_box_get_origin        (const ClutterActorBox *box,
    -                                                         gfloat *x,
    -                                                         gfloat *y);
    -void                clutter_actor_box_get_size          (const ClutterActorBox *box,
    -                                                         gfloat *width,
    -                                                         gfloat *height);
    -gfloat              clutter_actor_box_get_area          (const ClutterActorBox *box);
    -gboolean            clutter_actor_box_contains          (const ClutterActorBox *box,
    -                                                         gfloat x,
    -                                                         gfloat y);
    -void                clutter_actor_box_from_vertices     (ClutterActorBox *box,
    -                                                         const ClutterVertex verts[]);
    -void                clutter_actor_box_clamp_to_pixel    (ClutterActorBox *box);
    -void                clutter_actor_box_interpolate       (const ClutterActorBox *initial,
    -                                                         const ClutterActorBox *final,
    -                                                         gdouble progress,
    -                                                         ClutterActorBox *result);
    +ClutterActorBox *   clutter_actor_box_new               (gfloat x_1,
    +                                                         gfloat y_1,
    +                                                         gfloat x_2,
    +                                                         gfloat y_2);
    +ClutterActorBox *   clutter_actor_box_copy              (const ClutterActorBox *box);
    +void                clutter_actor_box_free              (ClutterActorBox *box);
    +gboolean            clutter_actor_box_equal             (const ClutterActorBox *box_a,
    +                                                         const ClutterActorBox *box_b);
    +gfloat              clutter_actor_box_get_x             (const ClutterActorBox *box);
    +gfloat              clutter_actor_box_get_y             (const ClutterActorBox *box);
    +gfloat              clutter_actor_box_get_width         (const ClutterActorBox *box);
    +gfloat              clutter_actor_box_get_height        (const ClutterActorBox *box);
    +void                clutter_actor_box_get_origin        (const ClutterActorBox *box,
    +                                                         gfloat *x,
    +                                                         gfloat *y);
    +void                clutter_actor_box_get_size          (const ClutterActorBox *box,
    +                                                         gfloat *width,
    +                                                         gfloat *height);
    +gfloat              clutter_actor_box_get_area          (const ClutterActorBox *box);
    +gboolean            clutter_actor_box_contains          (const ClutterActorBox *box,
    +                                                         gfloat x,
    +                                                         gfloat y);
    +void                clutter_actor_box_from_vertices     (ClutterActorBox *box,
    +                                                         const ClutterVertex verts[]);
    +void                clutter_actor_box_clamp_to_pixel    (ClutterActorBox *box);
    +void                clutter_actor_box_interpolate       (const ClutterActorBox *initial,
    +                                                         const ClutterActorBox *final,
    +                                                         gdouble progress,
    +                                                         ClutterActorBox *result);
     
                         ClutterVertex;
    -ClutterVertex *     clutter_vertex_new                  (gfloat x,
    -                                                         gfloat y,
    -                                                         gfloat z);
    -ClutterVertex *     clutter_vertex_copy                 (const ClutterVertex *vertex);
    -void                clutter_vertex_free                 (ClutterVertex *vertex);
    -gboolean            clutter_vertex_equal                (const ClutterVertex *vertex_a,
    -                                                         const ClutterVertex *vertex_b);
    +ClutterVertex *     clutter_vertex_new                  (gfloat x,
    +                                                         gfloat y,
    +                                                         gfloat z);
    +ClutterVertex *     clutter_vertex_copy                 (const ClutterVertex *vertex);
    +void                clutter_vertex_free                 (ClutterVertex *vertex);
    +gboolean            clutter_vertex_equal                (const ClutterVertex *vertex_a,
    +                                                         const ClutterVertex *vertex_b);
     

    Object Hierarchy

    -  GObject
    -   +----GInitiallyUnowned
    +  GObject
    +   +----GInitiallyUnowned
              +----ClutterActor
                    +----ClutterGroup
                    +----ClutterRectangle
    @@ -418,51 +687,121 @@
     

    Properties

    -  "allocation"               ClutterActorBox*      : Read
    -  "anchor-gravity"           ClutterGravity        : Read / Write
    -  "anchor-x"                 gfloat                : Read / Write
    -  "anchor-y"                 gfloat                : Read / Write
    -  "clip"                     ClutterGeometry*      : Read / Write
    -  "clip-to-allocation"       gboolean              : Read / Write
    -  "depth"                    gfloat                : Read / Write
    -  "fixed-position-set"       gboolean              : Read / Write
    -  "fixed-x"                  gfloat                : Read / Write
    -  "fixed-y"                  gfloat                : Read / Write
    -  "has-clip"                 gboolean              : Read
    -  "has-pointer"              gboolean              : Read
    -  "height"                   gfloat                : Read / Write
    -  "mapped"                   gboolean              : Read
    -  "min-height"               gfloat                : Read / Write
    -  "min-height-set"           gboolean              : Read / Write
    -  "min-width"                gfloat                : Read / Write
    -  "min-width-set"            gboolean              : Read / Write
    -  "name"                     gchar*                : Read / Write
    -  "natural-height"           gfloat                : Read / Write
    -  "natural-height-set"       gboolean              : Read / Write
    -  "natural-width"            gfloat                : Read / Write
    -  "natural-width-set"        gboolean              : Read / Write
    -  "opacity"                  guint                 : Read / Write
    -  "reactive"                 gboolean              : Read / Write
    -  "realized"                 gboolean              : Read
    -  "request-mode"             ClutterRequestMode    : Read / Write
    -  "rotation-angle-x"         gdouble               : Read / Write
    -  "rotation-angle-y"         gdouble               : Read / Write
    -  "rotation-angle-z"         gdouble               : Read / Write
    -  "rotation-center-x"        ClutterVertex*        : Read / Write
    -  "rotation-center-y"        ClutterVertex*        : Read / Write
    -  "rotation-center-z"        ClutterVertex*        : Read / Write
    -  "rotation-center-z-gravity" ClutterGravity        : Read / Write
    -  "scale-center-x"           gfloat                : Read / Write
    -  "scale-center-y"           gfloat                : Read / Write
    -  "scale-gravity"            ClutterGravity        : Read / Write
    -  "scale-x"                  gdouble               : Read / Write
    -  "scale-y"                  gdouble               : Read / Write
    -  "show-on-set-parent"       gboolean              : Read / Write
    -  "text-direction"           ClutterTextDirection  : Read / Write
    -  "visible"                  gboolean              : Read / Write
    -  "width"                    gfloat                : Read / Write
    -  "x"                        gfloat                : Read / Write
    -  "y"                        gfloat                : Read / Write
    +  "allocation"               ClutterActorBox*      : Read
    +  "anchor-gravity"           ClutterGravity        : Read / Write
    +  "anchor-x"                 gfloat                : Read / Write
    +  "anchor-y"                 gfloat                : Read / Write
    +  "clip"                     ClutterGeometry*      : Read / Write
    +  "clip-to-allocation"       gboolean              : Read / Write
    +  "depth"                    gfloat                : Read / Write
    +  "fixed-position-set"       gboolean              : Read / Write
    +  "fixed-x"                  gfloat                : Read / Write
    +  "fixed-y"                  gfloat                : Read / Write
    +  "has-clip"                 gboolean              : Read
    +  "has-pointer"              gboolean              : Read
    +  "height"                   gfloat                : Read / Write
    +  "mapped"                   gboolean              : Read
    +  "min-height"               gfloat                : Read / Write
    +  "min-height-set"           gboolean              : Read / Write
    +  "min-width"                gfloat                : Read / Write
    +  "min-width-set"            gboolean              : Read / Write
    +  "name"                     gchar*                : Read / Write
    +  "natural-height"           gfloat                : Read / Write
    +  "natural-height-set"       gboolean              : Read / Write
    +  "natural-width"            gfloat                : Read / Write
    +  "natural-width-set"        gboolean              : Read / Write
    +  "opacity"                  guint                 : Read / Write
    +  "reactive"                 gboolean              : Read / Write
    +  "realized"                 gboolean              : Read
    +  "request-mode"             ClutterRequestMode    : Read / Write
    +  "rotation-angle-x"         gdouble               : Read / Write
    +  "rotation-angle-y"         gdouble               : Read / Write
    +  "rotation-angle-z"         gdouble               : Read / Write
    +  "rotation-center-x"        ClutterVertex*        : Read / Write
    +  "rotation-center-y"        ClutterVertex*        : Read / Write
    +  "rotation-center-z"        ClutterVertex*        : Read / Write
    +  "rotation-center-z-gravity" ClutterGravity        : Read / Write
    +  "scale-center-x"           gfloat                : Read / Write
    +  "scale-center-y"           gfloat                : Read / Write
    +  "scale-gravity"            ClutterGravity        : Read / Write
    +  "scale-x"                  gdouble               : Read / Write
    +  "scale-y"                  gdouble               : Read / Write
    +  "show-on-set-parent"       gboolean              : Read / Write
    +  "text-direction"           ClutterTextDirection  : Read / Write
    +  "visible"                  gboolean              : Read / Write
    +  "width"                    gfloat                : Read / Write
    +  "x"                        gfloat                : Read / Write
    +  "y"                        gfloat                : Read / Write
     
    @@ -580,13 +919,13 @@
  • The stage is always reactive

  • Events are handled by connecting signal handlers to the numerous event signal types.

  • -
  • Event handlers must return TRUE if they handled - the event and wish to block the event emission chain, or FALSE +

  • Event handlers must return TRUE if they handled + the event and wish to block the event emission chain, or FALSE if the emission chain must continue

  • Keyboard events are emitted if actor has focus, see clutter_stage_set_key_focus()

  • Motion events (motion, enter, leave) are not emitted - if clutter_set_motion_events_enabled() is called with FALSE. + if clutter_set_motion_events_enabled() is called with FALSE. See clutter_set_motion_events_enabled() documentation for more information.

  • Once emitted, an event emission chain has two @@ -595,7 +934,7 @@ traversing every child actor until the event source actor is reached. The emission then enters the bubble phase, traversing back up the chain via parents until it reaches the stage. Any event handler can - abort this chain by returning TRUE (meaning "event handled"). + abort this chain by returning TRUE (meaning "event handled").

  • Pointer events will 'pass through' non reactive overlapping actors.

  • @@ -617,15 +956,19 @@

    For implementing a new custom actor class, please read the corresponding section of the API reference.

    +

    +

    Details

    -

    CLUTTER_ACTOR_SET_FLAGS()

    +

    CLUTTER_ACTOR_SET_FLAGS()

    #define CLUTTER_ACTOR_SET_FLAGS(a,f)    (((ClutterActor*)(a))->flags |= (f))
     

    Sets the given flags on a ClutterActor

    +

    +

    @@ -644,11 +987,13 @@
    -

    CLUTTER_ACTOR_UNSET_FLAGS()

    +

    CLUTTER_ACTOR_UNSET_FLAGS()

    #define CLUTTER_ACTOR_UNSET_FLAGS(a,f)  (((ClutterActor*)(a))->flags &= ~(f))
     

    Unsets the given flags on a ClutterActor

    +

    +

    @@ -667,22 +1012,24 @@
    -

    CLUTTER_ACTOR_IS_MAPPED()

    +

    CLUTTER_ACTOR_IS_MAPPED()

    #define CLUTTER_ACTOR_IS_MAPPED(a)      ((((ClutterActor*)(a))->flags & CLUTTER_ACTOR_MAPPED) != FALSE)
     

    -Evaluates to TRUE if the CLUTTER_ACTOR_MAPPED flag is set. +Evaluates to TRUE if the CLUTTER_ACTOR_MAPPED flag is set.

    Means "the actor will be painted if the stage is mapped."

    -TRUE if the actor is visible; and all parents with possible exception +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.

    Clutter auto-maintains the mapped flag whenever actors are reparented or shown/hidden.

    +

    +

    @@ -695,11 +1042,11 @@
    -

    CLUTTER_ACTOR_IS_REALIZED()

    +

    CLUTTER_ACTOR_IS_REALIZED()

    #define CLUTTER_ACTOR_IS_REALIZED(a)    ((((ClutterActor*)(a))->flags & CLUTTER_ACTOR_REALIZED) != FALSE)
     

    -Evaluates to TRUE if the CLUTTER_ACTOR_REALIZED flag is set. +Evaluates to TRUE if the CLUTTER_ACTOR_REALIZED flag is set.

    Whether GL resources such as textures are allocated; @@ -711,6 +1058,8 @@ 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.

    +

    +

    @@ -723,17 +1072,19 @@
    -

    CLUTTER_ACTOR_IS_VISIBLE()

    +

    CLUTTER_ACTOR_IS_VISIBLE()

    #define CLUTTER_ACTOR_IS_VISIBLE(a)     ((((ClutterActor*)(a))->flags & CLUTTER_ACTOR_VISIBLE) != FALSE)
     

    -Evaluates to TRUE if the actor has been shown, FALSE if it's hidden. +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.

    +

    +

    @@ -746,14 +1097,16 @@
    -

    CLUTTER_ACTOR_IS_REACTIVE()

    +

    CLUTTER_ACTOR_IS_REACTIVE()

    #define CLUTTER_ACTOR_IS_REACTIVE(a)    ((((ClutterActor*)(a))->flags & CLUTTER_ACTOR_REACTIVE) != FALSE)
     

    -Evaluates to TRUE if the CLUTTER_ACTOR_REACTIVE flag is set. +Evaluates to TRUE if the CLUTTER_ACTOR_REACTIVE flag is set.

    Only reactive actors will receive event-related signals.

    +

    +

    @@ -778,34 +1131,36 @@

    Flags used to signal the state of an actor.

    +

    +

    - + - + - + - + - +

    CLUTTER_ACTOR_MAPPED

    CLUTTER_ACTOR_MAPPED

    the actor will be painted (is visible, and inside a toplevel, and all parents visible)

    CLUTTER_ACTOR_REALIZED

    CLUTTER_ACTOR_REALIZED

    the resources associated to the actor have been allocated

    CLUTTER_ACTOR_REACTIVE

    CLUTTER_ACTOR_REACTIVE

    the actor 'reacts' to mouse events emmitting event signals

    CLUTTER_ACTOR_VISIBLE

    CLUTTER_ACTOR_VISIBLE

    the actor has been shown by the application program

    CLUTTER_ACTOR_NO_LAYOUT

    CLUTTER_ACTOR_NO_LAYOUT

    the actor provides an explicit layout management policy for its children; this flag will prevent Clutter from automatic queueing of relayout and will defer all layouting to the actor itself @@ -824,16 +1179,18 @@

    Specifies the type of requests for a ClutterActor.

    +

    +

    - + - + @@ -853,26 +1210,36 @@

    The rectangle containing an actor's bounding box, measured in pixels.

    +

    +

    CLUTTER_REQUEST_HEIGHT_FOR_WIDTH

    CLUTTER_REQUEST_HEIGHT_FOR_WIDTH

    Height for width requests

    CLUTTER_REQUEST_WIDTH_FOR_HEIGHT

    CLUTTER_REQUEST_WIDTH_FOR_HEIGHT

    Width for height requests
    - + - + - + - + @@ -881,11 +1248,13 @@
    -

    CLUTTER_CALLBACK()

    +

    CLUTTER_CALLBACK()

    #define CLUTTER_CALLBACK(f)        ((ClutterCallback) (f))
     

    Convenience macro to cast a function to ClutterCallback

    +

    +

    gint x;

    gint x;

    X coordinate of the top left corner of an actor

    gint y;

    gint y;

    Y coordinate of the top left corner of an actor

    guint width;

    guint width;

    width of an actor

    guint height;

    guint height;

    height of an actor
    @@ -898,10 +1267,14 @@

    ClutterCallback ()

    -
    void                (*ClutterCallback)                  (ClutterActor *actor,
    -                                                         gpointer data);
    +
    void                (*ClutterCallback)                  (ClutterActor *actor,
    +                                                         gpointer data);

    Generic callback

    +

    +

    @@ -927,10 +1300,14 @@

    Base class for actors.

    +

    +

    - + @@ -1005,17 +1382,19 @@

    Base class for actors.

    +

    +

    guint32 flags;

    guint32 flags;

    ClutterActorFlags
    - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + @@ -1187,13 +1566,15 @@

    clutter_actor_set_flags ()

    -
    void                clutter_actor_set_flags             (ClutterActor *self,
    -                                                         ClutterActorFlags flags);
    +
    void                clutter_actor_set_flags             (ClutterActor *self,
    +                                                         ClutterActorFlags flags);

    Sets flags on self

    This function will emit notifications for the changed properties

    +

    +

    show ()

    show ()

    signal class handler for "show"; it must chain up to the parent's implementation

    show_all ()

    show_all ()

    virtual function for containers and composite actors, to determine which children should be shown when calling clutter_actor_show_all() on the actor. Defaults to calling @@ -1023,13 +1402,13 @@

    hide ()

    hide ()

    signal class handler for "hide"; it must chain up to the parent's implementation

    hide_all ()

    hide_all ()

    virtual function for containers and composite actors, to determine which children should be shown when calling clutter_actor_hide_all() on the actor. Defaults to calling @@ -1037,147 +1416,147 @@

    realize ()

    realize ()

    virtual function, used to allocate resources for the actor; it should chain up to the parent's implementation

    unrealize ()

    unrealize ()

    virtual function, used to deallocate resources allocated in ::realize; it should chain up to the parent's implementation

    map ()

    map ()

    virtual function for containers and composite actors, to map their children; it must chain up to the parent's implementation

    unmap ()

    unmap ()

    virtual function for containers and composite actors, to unmap their children; it must chain up to the parent's implementation

    paint ()

    paint ()

    virtual function, used to paint the actor

    parent_set ()

    parent_set ()

    signal class handler for the "parent-set"

    destroy ()

    destroy ()

    signal class handler for "destroy"

    pick ()

    pick ()

    virtual function, used to draw an outline of the actor with the given color

    queue_redraw ()

    queue_redraw ()

    class handler for "queue-redraw"

    get_preferred_width ()

    get_preferred_width ()

    virtual function, used when querying the minimum and natural widths of an actor for a given height; it is used by clutter_actor_get_preferred_width()

    get_preferred_height ()

    get_preferred_height ()

    virtual function, used when querying the minimum and natural heights of an actor for a given width; it is used by clutter_actor_get_preferred_height()

    allocate ()

    allocate ()

    virtual function, used when settings the coordinates of an actor; it is used by clutter_actor_allocate(); it must chain up to the parent's implementation

    apply_transform ()

    apply_transform ()

    virtual function, used when applying the transformations to an actor before painting it or when transforming coordinates or the allocation; it must chain up to the parent's implementation

    event ()

    event ()

    class handler for "event"

    button_press_event ()

    button_press_event ()

    class handler for "button-press-event"

    button_release_event ()

    button_release_event ()

    class handler for "button-release-event"

    scroll_event ()

    scroll_event ()

    signal class closure for "scroll-event"

    key_press_event ()

    key_press_event ()

    signal class closure for "key-press-event"

    key_release_event ()

    key_release_event ()

    signal class closure for "key-release-event"

    motion_event ()

    motion_event ()

    signal class closure for "motion-event"

    enter_event ()

    enter_event ()

    signal class closure for "enter-event"

    leave_event ()

    leave_event ()

    signal class closure for "leave-event"

    captured_event ()

    captured_event ()

    signal class closure for "captured-event"

    key_focus_in ()

    key_focus_in ()

    signal class closure for "focus-in"

    key_focus_out ()

    key_focus_out ()

    signal class closure for "focus-out"

    queue_relayout ()

    queue_relayout ()

    class handler for "queue-relayout"
    @@ -1214,13 +1595,15 @@

    clutter_actor_unset_flags ()

    -
    void                clutter_actor_unset_flags           (ClutterActor *self,
    -                                                         ClutterActorFlags flags);
    +
    void                clutter_actor_unset_flags           (ClutterActor *self,
    +                                                         ClutterActorFlags flags);

    Unsets flags on self

    This function will emit notifications for the changed properties

    +

    +

    @@ -1241,9 +1624,11 @@

    clutter_actor_get_flags ()

    -
    ClutterActorFlags   clutter_actor_get_flags             (ClutterActor *self);
    +
    ClutterActorFlags   clutter_actor_get_flags             (ClutterActor *self);

    Retrieves the flags set on self

    +

    +

    @@ -1265,7 +1650,7 @@

    clutter_actor_show ()

    -
    void                clutter_actor_show                  (ClutterActor *self);
    +
    void                clutter_actor_show                  (ClutterActor *self);

    Flags an actor to be displayed. An actor that isn't shown will not be rendered on the stage. @@ -1275,8 +1660,10 @@

    If this function is called on an actor without a parent, the -"show-on-set-parent" will be set to TRUE as a side +"show-on-set-parent" will be set to TRUE as a side effect.

    +

    +

    @@ -1289,9 +1676,11 @@

    clutter_actor_show_all ()

    -
    void                clutter_actor_show_all              (ClutterActor *self);
    +
    void                clutter_actor_show_all              (ClutterActor *self);

    Calls clutter_actor_show() on all children of an actor (if any).

    +

    +

    @@ -1305,7 +1694,7 @@

    clutter_actor_hide ()

    -
    void                clutter_actor_hide                  (ClutterActor *self);
    +
    void                clutter_actor_hide                  (ClutterActor *self);

    Flags an actor to be hidden. A hidden actor will not be rendered on the stage. @@ -1315,8 +1704,10 @@

    If this function is called on an actor without a parent, the -"show-on-set-parent" property will be set to FALSE +"show-on-set-parent" property will be set to FALSE as a side-effect.

    +

    +

    @@ -1329,9 +1720,11 @@

    clutter_actor_hide_all ()

    -
    void                clutter_actor_hide_all              (ClutterActor *self);
    +
    void                clutter_actor_hide_all              (ClutterActor *self);

    Calls clutter_actor_hide() on all child actors (if any).

    +

    +

    @@ -1345,7 +1738,7 @@

    clutter_actor_realize ()

    -
    void                clutter_actor_realize               (ClutterActor *self);
    +
    void                clutter_actor_realize               (ClutterActor *self);

    Creates any underlying graphics resources needed by the actor to be displayed. @@ -1365,6 +1758,8 @@ 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.

    +

    +

    @@ -1377,7 +1772,7 @@

    clutter_actor_unrealize ()

    -
    void                clutter_actor_unrealize             (ClutterActor *self);
    +
    void                clutter_actor_unrealize             (ClutterActor *self);

    Frees up any underlying graphics resources needed by the actor to be displayed. @@ -1412,6 +1807,8 @@ create your resources in a different way, then use _clutter_actor_rerealize() (inside Clutter) or just call your code that recreates your resources directly (outside Clutter).

    +

    +

    @@ -1424,7 +1821,7 @@

    clutter_actor_paint ()

    -
    void                clutter_actor_paint                 (ClutterActor *self);
    +
    void                clutter_actor_paint                 (ClutterActor *self);

    Renders the actor to display.

    @@ -1434,6 +1831,8 @@

    This function will emit the "paint" signal.

    +

    +

    @@ -1446,7 +1845,7 @@

    clutter_actor_queue_redraw ()

    -
    void                clutter_actor_queue_redraw          (ClutterActor *self);
    +
    void                clutter_actor_queue_redraw          (ClutterActor *self);

    Queues up a redraw of an actor and any children. The redraw occurs once the main loop becomes idle (after the current batch of events @@ -1463,6 +1862,8 @@

    Also be aware that painting is a NOP for actors with an opacity of 0

    +

    +

    @@ -1475,7 +1876,7 @@

    clutter_actor_queue_relayout ()

    -
    void                clutter_actor_queue_relayout        (ClutterActor *self);
    +
    void                clutter_actor_queue_relayout        (ClutterActor *self);

    Indicates that the actor's size request or other layout-affecting properties may have changed. This function is used inside ClutterActor @@ -1483,6 +1884,8 @@

    Queueing a new layout automatically queues a redraw as well.

    +

    +

    @@ -1496,7 +1899,7 @@

    clutter_actor_destroy ()

    -
    void                clutter_actor_destroy               (ClutterActor *self);
    +
    void                clutter_actor_destroy               (ClutterActor *self);

    Destroys an actor. When an actor is destroyed, it will break any references it holds to other objects. If the actor is inside a @@ -1508,6 +1911,8 @@

    Note: you cannot destroy the ClutterStage returned by clutter_stage_get_default().

    +

    +

    @@ -1520,13 +1925,19 @@

    clutter_actor_event ()

    -
    gboolean            clutter_actor_event                 (ClutterActor *actor,
    -                                                         ClutterEvent *event,
    -                                                         gboolean capture);
    +
    gboolean            clutter_actor_event                 (ClutterActor *actor,
    +                                                         ClutterEvent *event,
    +                                                         gboolean capture);

    This function is used to emit an event on the main stage. You should rarely need to use this function, except for synthetising events.

    +

    +

    @@ -1547,8 +1958,8 @@ - @@ -1560,7 +1971,9 @@

    clutter_actor_should_pick_paint ()

    -
    gboolean            clutter_actor_should_pick_paint     (ClutterActor *self);
    +
    gboolean            clutter_actor_should_pick_paint     (ClutterActor *self);

    Should be called inside the implementation of the "pick" virtual function in order to check whether @@ -1568,6 +1981,8 @@

    This function should never be called directly by applications.

    +

    +

    Returns :

    the return value from the signal emission: TRUE - if the actor handled the event, or FALSE if the event was + the return value from the signal emission: TRUE + if the actor handled the event, or FALSE if the event was not handled
    @@ -1578,8 +1993,8 @@ - @@ -1588,9 +2003,9 @@

    clutter_actor_map ()

    -
    void                clutter_actor_map                   (ClutterActor *self);
    +
    void                clutter_actor_map                   (ClutterActor *self);

    -Sets the CLUTTER_ACTOR_MAPPED flag on the actor and possibly maps +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.

    @@ -1604,6 +2019,8 @@

    When overriding map, it is mandatory to chain up to the parent implementation.

    +

    +

    Returns :

    TRUE if the actor should paint its silhouette, - FALSE otherwise + TRUE if the actor should paint its silhouette, + FALSE otherwise
    @@ -1617,9 +2034,9 @@

    clutter_actor_unmap ()

    -
    void                clutter_actor_unmap                 (ClutterActor *self);
    +
    void                clutter_actor_unmap                 (ClutterActor *self);

    -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.

    @@ -1632,6 +2049,8 @@

    When overriding unmap, it is mandatory to chain up to the parent implementation.

    +

    +

    @@ -1652,18 +2071,20 @@ } ClutterAllocationFlags;

    -Flags passed to the ClutterActor::allocate() virtual function and +Flags passed to the ""allocate() virtual function and to the clutter_actor_allocate() function

    +

    +

    - + - +

    CLUTTER_ALLOCATION_NONE

    CLUTTER_ALLOCATION_NONE

    No flag set

    CLUTTER_ABSOLUTE_ORIGIN_CHANGED

    CLUTTER_ABSOLUTE_ORIGIN_CHANGED

    Whether the absolute origin of the actor has changed; this implies that any ancestor of the actor has been moved @@ -1676,9 +2097,9 @@

    clutter_actor_allocate ()

    -
    void                clutter_actor_allocate              (ClutterActor *self,
    -                                                         const ClutterActorBox *box,
    -                                                         ClutterAllocationFlags flags);
    +
    void                clutter_actor_allocate              (ClutterActor *self,
    +                                                         const ClutterActorBox *box,
    +                                                         ClutterAllocationFlags flags);

    Called by the parent of an actor to assign the actor its size. Should never be called by applications (except when implementing @@ -1690,6 +2111,8 @@ additional information about the allocation, for instance whether the parent has moved with respect to the stage, for example because a grandparent's origin has moved.

    +

    +

    @@ -1715,9 +2138,9 @@

    clutter_actor_allocate_preferred_size ()

    -
    void                clutter_actor_allocate_preferred_size
    -                                                        (ClutterActor *self,
    -                                                         ClutterAllocationFlags flags);
    +
    void                clutter_actor_allocate_preferred_size
    +                                                        (ClutterActor *self,
    +                                                         ClutterAllocationFlags flags);

    Allocates the natural size of self.

    @@ -1733,6 +2156,8 @@ 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.

    +

    +

    @@ -1753,13 +2178,21 @@

    clutter_actor_allocate_available_size ()

    -
    void                clutter_actor_allocate_available_size
    -                                                        (ClutterActor *self,
    -                                                         gfloat x,
    -                                                         gfloat y,
    -                                                         gfloat available_width,
    -                                                         gfloat available_height,
    -                                                         ClutterAllocationFlags flags);
    +
    void                clutter_actor_allocate_available_size
    +                                                        (ClutterActor *self,
    +                                                         gfloat x,
    +                                                         gfloat y,
    +                                                         gfloat available_width,
    +                                                         gfloat available_height,
    +                                                         ClutterAllocationFlags flags);

    Allocates self taking into account the ClutterActor's preferred size, but limiting it to the maximum available width @@ -1811,6 +2244,8 @@ This function can be used by fluid layout managers to allocate an actor's preferred size without making it bigger than the area available for the container.

    +

    +

    @@ -1853,8 +2288,8 @@

    clutter_actor_get_allocation_box ()

    -
    void                clutter_actor_get_allocation_box    (ClutterActor *self,
    -                                                         ClutterActorBox *box);
    +
    void                clutter_actor_get_allocation_box    (ClutterActor *self,
    +                                                         ClutterActorBox *box);

    Gets the layout box an actor has been assigned. The allocation can only be assumed valid inside a paint() method; anywhere else, it @@ -1870,6 +2305,8 @@

    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.
    +

    +

    @@ -1880,7 +2317,7 @@ - +

    box :

    the function fills this in with the actor's allocation. out. the function fills this in with the actor's allocation. out.
    @@ -1889,9 +2326,9 @@

    clutter_actor_get_allocation_geometry ()

    -
    void                clutter_actor_get_allocation_geometry
    -                                                        (ClutterActor *self,
    -                                                         ClutterGeometry *geom);
    +
    void                clutter_actor_get_allocation_geometry
    +                                                        (ClutterActor *self,
    +                                                         ClutterGeometry *geom);

    Gets the layout box an actor has been assigned. The allocation can only be assumed valid inside a paint() method; anywhere else, it @@ -1903,6 +2340,8 @@

    The returned rectangle is in pixels.

    +

    +

    @@ -1913,7 +2352,7 @@ - +

    geom :

    allocation geometry in pixels. out. allocation geometry in pixels. out.
    @@ -1922,10 +2361,10 @@

    clutter_actor_get_allocation_vertices ()

    -
    void                clutter_actor_get_allocation_vertices
    -                                                        (ClutterActor *self,
    -                                                         ClutterActor *ancestor,
    -                                                         ClutterVertex verts[]);
    +
    void                clutter_actor_get_allocation_vertices
    +                                                        (ClutterActor *self,
    +                                                         ClutterActor *ancestor,
    +                                                         ClutterVertex verts[]);

    Calculates the transformed coordinates of the four corners of the actor in the plane of ancestor. The returned vertices relate to @@ -1940,10 +2379,12 @@

    -If ancestor is NULL the ancestor will be the ClutterStage. In +If ancestor is NULL the ancestor will be the ClutterStage. In this case, the coordinates returned will be the coordinates on the stage before the projection is applied. This is different from the behaviour of clutter_actor_get_abs_allocation_vertices().

    +

    +

    @@ -1954,11 +2395,11 @@ - + - +

    ancestor :

    allow-none. allow-none. allow-none. allow-none.

    verts :

    out) (array fixed-size=4. out. array fixed-size=4. out) (array fixed-size=4. out. array fixed-size=4.
    @@ -1967,11 +2408,19 @@

    clutter_actor_get_preferred_size ()

    -
    void                clutter_actor_get_preferred_size    (ClutterActor *self,
    -                                                         gfloat *min_width_p,
    -                                                         gfloat *min_height_p,
    -                                                         gfloat *natural_width_p,
    -                                                         gfloat *natural_height_p);
    +
    void                clutter_actor_get_preferred_size    (ClutterActor *self,
    +                                                         gfloat *min_width_p,
    +                                                         gfloat *min_height_p,
    +                                                         gfloat *natural_width_p,
    +                                                         gfloat *natural_height_p);

    Computes the preferred minimum and natural size of an actor, taking into account the actor's geometry management (either height-for-width @@ -1986,6 +2435,8 @@ 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 "request-mode" property.

    +

    +

    @@ -1996,19 +2447,19 @@ - + - + - + - +

    min_width_p :

    out) (allow-none. out. allow-none. out) (allow-none. out. allow-none.

    min_height_p :

    out) (allow-none. out. allow-none. out) (allow-none. out. allow-none.

    natural_width_p :

    out) (allow-none. out. allow-none. out) (allow-none. out. allow-none.

    natural_height_p :

    out) (allow-none. out. allow-none. out) (allow-none. out. allow-none.
    @@ -2017,10 +2468,16 @@

    clutter_actor_get_preferred_width ()

    -
    void                clutter_actor_get_preferred_width   (ClutterActor *self,
    -                                                         gfloat for_height,
    -                                                         gfloat *min_width_p,
    -                                                         gfloat *natural_width_p);
    +
    void                clutter_actor_get_preferred_width   (ClutterActor *self,
    +                                                         gfloat for_height,
    +                                                         gfloat *min_width_p,
    +                                                         gfloat *natural_width_p);

    Computes the requested minimum and natural widths for an actor, optionally depending on the specified height, or if they are @@ -2033,6 +2490,8 @@

    A request should not incorporate the actor's scale or anchor point; those transformations do not affect layout, only rendering.

    +

    +

    @@ -2049,11 +2508,11 @@ - + - +

    min_width_p :

    out) (allow-none. out. allow-none. out) (allow-none. out. allow-none.

    natural_width_p :

    out) (allow-none. out. allow-none. out) (allow-none. out. allow-none.
    @@ -2062,10 +2521,16 @@

    clutter_actor_get_preferred_height ()

    -
    void                clutter_actor_get_preferred_height  (ClutterActor *self,
    -                                                         gfloat for_width,
    -                                                         gfloat *min_height_p,
    -                                                         gfloat *natural_height_p);
    +
    void                clutter_actor_get_preferred_height  (ClutterActor *self,
    +                                                         gfloat for_width,
    +                                                         gfloat *min_height_p,
    +                                                         gfloat *natural_height_p);

    Computes the requested minimum and natural heights for an actor, or if they are already computed, returns the cached values. @@ -2077,6 +2542,8 @@

    A request should not incorporate the actor's scale or anchor point; those transformations do not affect layout, only rendering.

    +

    +

    @@ -2093,11 +2560,11 @@ - + - +

    min_height_p :

    out) (allow-none. out. allow-none. out) (allow-none. out. allow-none.

    natural_height_p :

    out) (allow-none. out. allow-none. out) (allow-none. out. allow-none.
    @@ -2106,12 +2573,16 @@

    clutter_actor_set_fixed_position_set ()

    -
    void                clutter_actor_set_fixed_position_set
    -                                                        (ClutterActor *self,
    -                                                         gboolean is_set);
    +
    void                clutter_actor_set_fixed_position_set
    +                                                        (ClutterActor *self,
    +                                                         gboolean is_set);

    Sets whether an actor has a fixed position set (and will thus be unaffected by any layout manager).

    +

    +

    @@ -2132,11 +2603,15 @@

    clutter_actor_get_fixed_position_set ()

    -
    gboolean            clutter_actor_get_fixed_position_set
    -                                                        (ClutterActor *self);
    +
    gboolean            clutter_actor_get_fixed_position_set
    +                                                        (ClutterActor *self);

    Checks whether an actor has a fixed position set (and will thus be unaffected by any layout manager).

    +

    +

    @@ -2147,7 +2622,7 @@ - @@ -2158,8 +2633,8 @@

    clutter_actor_set_request_mode ()

    -
    void                clutter_actor_set_request_mode      (ClutterActor *self,
    -                                                         ClutterRequestMode mode);
    +
    void                clutter_actor_set_request_mode      (ClutterActor *self,
    +                                                         ClutterRequestMode mode);

    Sets the geometry request mode of self.

    @@ -2167,6 +2642,8 @@ The mode determines the order for invoking clutter_actor_get_preferred_width() and clutter_actor_get_preferred_height()

    +

    +

    Returns :

    TRUE if the fixed position is set on the actor + TRUE if the fixed position is set on the actor
    @@ -2187,9 +2664,11 @@

    clutter_actor_get_request_mode ()

    -
    ClutterRequestMode  clutter_actor_get_request_mode      (ClutterActor *self);
    +
    ClutterRequestMode  clutter_actor_get_request_mode      (ClutterActor *self);

    Retrieves the geometry request mode of self

    +

    +

    @@ -2211,13 +2690,15 @@

    clutter_actor_set_geometry ()

    -
    void                clutter_actor_set_geometry          (ClutterActor *self,
    -                                                         const ClutterGeometry *geometry);
    +
    void                clutter_actor_set_geometry          (ClutterActor *self,
    +                                                         const ClutterGeometry *geometry);

    Sets the actor's fixed position and forces its minimum and natural size, in pixels. This means the untransformed actor will have the given geometry. This is the same as calling clutter_actor_set_position() and clutter_actor_set_size().

    +

    +

    @@ -2237,13 +2718,15 @@

    clutter_actor_get_geometry ()

    -
    void                clutter_actor_get_geometry          (ClutterActor *self,
    -                                                         ClutterGeometry *geometry);
    +
    void                clutter_actor_get_geometry          (ClutterActor *self,
    +                                                         ClutterGeometry *geometry);

    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.

    +

    +

    @@ -2254,7 +2737,7 @@ - +

    geometry :

    A location to store actors ClutterGeometry. out. A location to store actors ClutterGeometry. out.
    @@ -2262,9 +2745,13 @@

    clutter_actor_set_size ()

    -
    void                clutter_actor_set_size              (ClutterActor *self,
    -                                                         gfloat width,
    -                                                         gfloat height);
    +
    void                clutter_actor_set_size              (ClutterActor *self,
    +                                                         gfloat width,
    +                                                         gfloat height);

    Sets the actor's size request in pixels. This overrides any "normal" size request the actor would have. For example @@ -2278,6 +2765,8 @@

    This function sets or unsets both the minimum and natural size.

    +

    +

    @@ -2302,9 +2791,13 @@

    clutter_actor_get_size ()

    -
    void                clutter_actor_get_size              (ClutterActor *self,
    -                                                         gfloat *width,
    -                                                         gfloat *height);
    +
    void                clutter_actor_get_size              (ClutterActor *self,
    +                                                         gfloat *width,
    +                                                         gfloat *height);

    This function tries to "do what you mean" and return the size an actor will have. If the actor has a valid @@ -2316,6 +2809,8 @@ should probably call a different function like clutter_actor_get_allocation_box() or clutter_actor_get_preferred_width().

    +

    +

    @@ -2326,11 +2821,11 @@ - + - +

    width :

    return location for the width, or NULL.. out. allow-none. return location for the width, or NULL.. out. allow-none.

    height :

    return location for the height, or NULL.. out. allow-none. return location for the height, or NULL.. out. allow-none.
    @@ -2339,9 +2834,13 @@

    clutter_actor_set_position ()

    -
    void                clutter_actor_set_position          (ClutterActor *self,
    -                                                         gfloat x,
    -                                                         gfloat y);
    +
    void                clutter_actor_set_position          (ClutterActor *self,
    +                                                         gfloat x,
    +                                                         gfloat y);

    Sets the actor's fixed position in pixels relative to any parent actor. @@ -2349,6 +2848,8 @@

    If a layout manager is in use, this position will override the layout manager and force a fixed position.

    +

    +

    @@ -2373,9 +2874,13 @@

    clutter_actor_get_position ()

    -
    void                clutter_actor_get_position          (ClutterActor *self,
    -                                                         gfloat *x,
    -                                                         gfloat *y);
    +
    void                clutter_actor_get_position          (ClutterActor *self,
    +                                                         gfloat *x,
    +                                                         gfloat *y);

    This function tries to "do what you mean" and tell you where the actor is, prior to any transformations. Retrieves the fixed @@ -2385,6 +2890,8 @@

    The returned position is in pixels.

    +

    +

    @@ -2395,11 +2902,11 @@ - + - +

    x :

    return location for the X coordinate, or NULL. out. allow-none. return location for the X coordinate, or NULL. out. allow-none.

    y :

    return location for the Y coordinate, or NULL. out. allow-none. return location for the Y coordinate, or NULL. out. allow-none.
    @@ -2408,8 +2915,10 @@

    clutter_actor_set_width ()

    -
    void                clutter_actor_set_width             (ClutterActor *self,
    -                                                         gfloat width);
    +
    void                clutter_actor_set_width             (ClutterActor *self,
    +                                                         gfloat width);

    Forces a width on an actor, causing the actor's preferred width and height (if any) to be ignored. @@ -2420,6 +2929,8 @@

    This function sets both the minimum and natural size of the actor.

    +

    +

    @@ -2440,7 +2951,9 @@

    clutter_actor_get_width ()

    -
    gfloat              clutter_actor_get_width             (ClutterActor *self);
    +
    gfloat              clutter_actor_get_width             (ClutterActor *self);

    Retrieves the width of a ClutterActor.

    @@ -2464,6 +2977,8 @@ 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.

    +

    +

    @@ -2483,8 +2998,10 @@

    clutter_actor_set_height ()

    -
    void                clutter_actor_set_height            (ClutterActor *self,
    -                                                         gfloat height);
    +
    void                clutter_actor_set_height            (ClutterActor *self,
    +                                                         gfloat height);

    Forces a height on an actor, causing the actor's preferred width and height (if any) to be ignored. @@ -2495,6 +3012,8 @@

    This function sets both the minimum and natural size of the actor.

    +

    +

    @@ -2515,7 +3034,9 @@

    clutter_actor_get_height ()

    -
    gfloat              clutter_actor_get_height            (ClutterActor *self);
    +
    gfloat              clutter_actor_get_height            (ClutterActor *self);

    Retrieves the height of a ClutterActor.

    @@ -2539,6 +3060,8 @@ 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.

    +

    +

    @@ -2558,14 +3081,18 @@

    clutter_actor_set_x ()

    -
    void                clutter_actor_set_x                 (ClutterActor *self,
    -                                                         gfloat x);
    +
    void                clutter_actor_set_x                 (ClutterActor *self,
    +                                                         gfloat x);

    Sets the actor's X coordinate, relative to its parent, in pixels.

    Overrides any layout manager and forces a fixed position for the actor.

    +

    +

    @@ -2586,7 +3113,9 @@

    clutter_actor_get_x ()

    -
    gfloat              clutter_actor_get_x                 (ClutterActor *self);
    +
    gfloat              clutter_actor_get_x                 (ClutterActor *self);

    Retrieves the X coordinate of a ClutterActor.

    @@ -2606,6 +3135,8 @@

    If both the allocation and a fixed position are missing, this function will return 0.

    +

    +

    @@ -2626,14 +3157,18 @@

    clutter_actor_set_y ()

    -
    void                clutter_actor_set_y                 (ClutterActor *self,
    -                                                         gfloat y);
    +
    void                clutter_actor_set_y                 (ClutterActor *self,
    +                                                         gfloat y);

    Sets the actor's Y coordinate, relative to its parent, in pixels.#

    Overrides any layout manager and forces a fixed position for the actor.

    +

    +

    @@ -2654,7 +3189,9 @@

    clutter_actor_get_y ()

    -
    gfloat              clutter_actor_get_y                 (ClutterActor *self);
    +
    gfloat              clutter_actor_get_y                 (ClutterActor *self);

    Retrieves the Y coordinate of a ClutterActor.

    @@ -2674,6 +3211,8 @@

    If both the allocation and a fixed position are missing, this function will return 0.

    +

    +

    @@ -2694,9 +3233,13 @@

    clutter_actor_move_by ()

    -
    void                clutter_actor_move_by               (ClutterActor *self,
    -                                                         gfloat dx,
    -                                                         gfloat dy);
    +
    void                clutter_actor_move_by               (ClutterActor *self,
    +                                                         gfloat dx,
    +                                                         gfloat dy);

    Moves an actor by the specified distance relative to its current position in pixels. @@ -2705,6 +3248,8 @@ This function modifies the fixed position of an actor and thus removes it from any layout management. Another way to move an actor is with an anchor point, see clutter_actor_set_anchor_point().

    +

    +

    @@ -2730,12 +3275,20 @@

    clutter_actor_set_rotation ()

    -
    void                clutter_actor_set_rotation          (ClutterActor *self,
    -                                                         ClutterRotateAxis axis,
    -                                                         gdouble angle,
    -                                                         gfloat x,
    -                                                         gfloat y,
    -                                                         gfloat z);
    +
    void                clutter_actor_set_rotation          (ClutterActor *self,
    +                                                         ClutterRotateAxis axis,
    +                                                         gdouble angle,
    +                                                         gfloat x,
    +                                                         gfloat y,
    +                                                         gfloat z);

    Sets the rotation angle of self around the given axis.

    @@ -2743,9 +3296,9 @@ The rotation center coordinates used depend on the value of axis:

    @@ -2753,6 +3306,8 @@ 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.

    +

    +

    @@ -2793,16 +3348,20 @@

    clutter_actor_set_z_rotation_from_gravity ()

    -
    void                clutter_actor_set_z_rotation_from_gravity
    -                                                        (ClutterActor *self,
    -                                                         gdouble angle,
    -                                                         ClutterGravity gravity);
    +
    void                clutter_actor_set_z_rotation_from_gravity
    +                                                        (ClutterActor *self,
    +                                                         gdouble angle,
    +                                                         ClutterGravity gravity);

    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 +CLUTTER_GRAVITY_CENTER. If the actor changes size the center point will move accordingly.

    +

    +

    @@ -2828,14 +3387,24 @@

    clutter_actor_get_rotation ()

    -
    gdouble             clutter_actor_get_rotation          (ClutterActor *self,
    -                                                         ClutterRotateAxis axis,
    -                                                         gfloat *x,
    -                                                         gfloat *y,
    -                                                         gfloat *z);
    +
    gdouble             clutter_actor_get_rotation          (ClutterActor *self,
    +                                                         ClutterRotateAxis axis,
    +                                                         gfloat *x,
    +                                                         gfloat *y,
    +                                                         gfloat *z);

    Retrieves the angle and center of rotation on the given axis, set using clutter_actor_set_rotation().

    +

    +

    @@ -2851,15 +3420,15 @@ - + - + - + @@ -2874,12 +3443,14 @@

    clutter_actor_get_z_rotation_gravity ()

    -
    ClutterGravity      clutter_actor_get_z_rotation_gravity
    -                                                        (ClutterActor *self);
    +
    ClutterGravity      clutter_actor_get_z_rotation_gravity
    +                                                        (ClutterActor *self);

    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.

    +this will return CLUTTER_GRAVITY_NONE.

    +

    +

    x :

    return value for the X coordinate of the center of rotation. out. return value for the X coordinate of the center of rotation. out.

    y :

    return value for the Y coordinate of the center of rotation. out. return value for the Y coordinate of the center of rotation. out.

    z :

    return value for the Z coordinate of the center of rotation. out. return value for the Z coordinate of the center of rotation. out.

    Returns :

    @@ -2901,9 +3472,13 @@

    clutter_actor_is_rotated ()

    -
    gboolean            clutter_actor_is_rotated            (ClutterActor *self);
    +
    gboolean            clutter_actor_is_rotated            (ClutterActor *self);

    Checks whether any rotation is applied to the actor.

    +

    +

    @@ -2914,7 +3489,7 @@ - @@ -2925,11 +3500,15 @@

    clutter_actor_set_opacity ()

    -
    void                clutter_actor_set_opacity           (ClutterActor *self,
    -                                                         guint8 opacity);
    +
    void                clutter_actor_set_opacity           (ClutterActor *self,
    +                                                         guint8 opacity);

    Sets the actor's opacity, with zero being completely transparent and 255 (0xff) being fully opaque.

    +

    +

    Returns :

    TRUE if the actor is rotated. + TRUE if the actor is rotated.
    @@ -2949,7 +3528,9 @@

    clutter_actor_get_opacity ()

    -
    guint8              clutter_actor_get_opacity           (ClutterActor *self);
    +
    guint8              clutter_actor_get_opacity           (ClutterActor *self);

    Retrieves the opacity value of an actor, as set by clutter_actor_set_opacity(). @@ -2957,6 +3538,8 @@

    For retrieving the absolute opacity of the actor inside a paint virtual function, see clutter_actor_get_paint_opacity().

    +

    +

    @@ -2976,11 +3559,15 @@

    clutter_actor_set_name ()

    -
    void                clutter_actor_set_name              (ClutterActor *self,
    -                                                         const gchar *name);
    +
    void                clutter_actor_set_name              (ClutterActor *self,
    +                                                         const gchar *name);

    Sets the given name to self. The name can be used to identify a ClutterActor.

    +

    +

    @@ -3000,9 +3587,13 @@

    clutter_actor_get_name ()

    -
    const gchar *       clutter_actor_get_name              (ClutterActor *self);
    +
    const gchar *       clutter_actor_get_name              (ClutterActor *self);

    Retrieves the name of self.

    +

    +

    @@ -3013,7 +3604,7 @@ - @@ -3023,9 +3614,13 @@

    clutter_actor_get_gid ()

    -
    guint32             clutter_actor_get_gid               (ClutterActor *self);
    +
    guint32             clutter_actor_get_gid               (ClutterActor *self);

    Retrieves the unique id for self.

    +

    +

    Returns :

    the name of the actor, or NULL. The returned string is + the name of the actor, or NULL. The returned string is owned by the actor and should not be modified or freed.
    @@ -3047,15 +3642,25 @@

    clutter_actor_set_clip ()

    -
    void                clutter_actor_set_clip              (ClutterActor *self,
    -                                                         gfloat xoff,
    -                                                         gfloat yoff,
    -                                                         gfloat width,
    -                                                         gfloat height);
    +
    void                clutter_actor_set_clip              (ClutterActor *self,
    +                                                         gfloat xoff,
    +                                                         gfloat yoff,
    +                                                         gfloat width,
    +                                                         gfloat height);

    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.

    +

    +

    @@ -3091,9 +3696,11 @@

    clutter_actor_remove_clip ()

    -
    void                clutter_actor_remove_clip           (ClutterActor *self);
    +
    void                clutter_actor_remove_clip           (ClutterActor *self);

    Removes clip area from self.

    +

    +

    @@ -3106,9 +3713,13 @@

    clutter_actor_has_clip ()

    -
    gboolean            clutter_actor_has_clip              (ClutterActor *self);
    +
    gboolean            clutter_actor_has_clip              (ClutterActor *self);

    Determines whether the actor has a clip area set or not.

    +

    +

    @@ -3119,7 +3730,7 @@ - @@ -3130,13 +3741,23 @@

    clutter_actor_get_clip ()

    -
    void                clutter_actor_get_clip              (ClutterActor *self,
    -                                                         gfloat *xoff,
    -                                                         gfloat *yoff,
    -                                                         gfloat *width,
    -                                                         gfloat *height);
    +
    void                clutter_actor_get_clip              (ClutterActor *self,
    +                                                         gfloat *xoff,
    +                                                         gfloat *yoff,
    +                                                         gfloat *width,
    +                                                         gfloat *height);

    Gets the clip area for self, if any is set

    +

    +

    Returns :

    TRUE if the actor has a clip area set. + TRUE if the actor has a clip area set.
    @@ -3147,19 +3768,19 @@ - + - + - + - +

    xoff :

    out) (allow-none. out. allow-none. out) (allow-none. out. allow-none.

    yoff :

    out) (allow-none. out. allow-none. out) (allow-none. out. allow-none.

    width :

    out) (allow-none. out. allow-none. out) (allow-none. out. allow-none.

    height :

    out) (allow-none. out. allow-none. out) (allow-none. out. allow-none.
    @@ -3168,8 +3789,8 @@

    clutter_actor_set_parent ()

    -
    void                clutter_actor_set_parent            (ClutterActor *self,
    -                                                         ClutterActor *parent);
    +
    void                clutter_actor_set_parent            (ClutterActor *self,
    +                                                         ClutterActor *parent);

    Sets the parent of self to parent. The opposite function is clutter_actor_unparent(). @@ -3177,6 +3798,8 @@

    This function should not be used by applications, but by custom container actor subclasses.

    +

    +

    @@ -3196,9 +3819,11 @@

    clutter_actor_get_parent ()

    -
    ClutterActor *      clutter_actor_get_parent            (ClutterActor *self);
    +
    ClutterActor *      clutter_actor_get_parent            (ClutterActor *self);

    Retrieves the parent of self.

    +

    +

    @@ -3209,7 +3834,7 @@ - +

    Returns :

    transfer none. transfer none. transfer none. transfer none.
    @@ -3217,8 +3842,8 @@

    clutter_actor_reparent ()

    -
    void                clutter_actor_reparent              (ClutterActor *self,
    -                                                         ClutterActor *new_parent);
    +
    void                clutter_actor_reparent              (ClutterActor *self,
    +                                                         ClutterActor *new_parent);

    This function resets the parent actor of self. It is logically equivalent to calling clutter_actor_unparent() @@ -3226,6 +3851,8 @@ implemented, ensures the child is not finalized when unparented, and emits the parent-set signal only one time.

    +

    +

    @@ -3246,7 +3873,7 @@

    clutter_actor_unparent ()

    -
    void                clutter_actor_unparent              (ClutterActor *self);
    +
    void                clutter_actor_unparent              (ClutterActor *self);

    Removes the parent of self.

    @@ -3254,6 +3881,8 @@ This function should not be used in applications. It should be called by implementations of container actors, to dissociate a child from the container.

    +

    +

    @@ -3267,8 +3896,8 @@

    clutter_actor_raise ()

    -
    void                clutter_actor_raise                 (ClutterActor *self,
    -                                                         ClutterActor *below);
    +
    void                clutter_actor_raise                 (ClutterActor *self,
    +                                                         ClutterActor *below);

    Puts self above below.

    @@ -3278,6 +3907,8 @@

    This function is the equivalent of clutter_container_raise_child().

    +

    +

    @@ -3288,7 +3919,7 @@ - +

    below :

    A ClutterActor to raise above.. allow-none. A ClutterActor to raise above.. allow-none.
    @@ -3296,8 +3927,8 @@

    clutter_actor_lower ()

    -
    void                clutter_actor_lower                 (ClutterActor *self,
    -                                                         ClutterActor *above);
    +
    void                clutter_actor_lower                 (ClutterActor *self,
    +                                                         ClutterActor *above);

    Puts self below above.

    @@ -3307,6 +3938,8 @@

    This function is the equivalent of clutter_container_lower_child().

    +

    +

    @@ -3317,7 +3950,7 @@ - +

    above :

    A ClutterActor to lower below. allow-none. A ClutterActor to lower below. allow-none.
    @@ -3325,12 +3958,14 @@

    clutter_actor_raise_top ()

    -
    void                clutter_actor_raise_top             (ClutterActor *self);
    +
    void                clutter_actor_raise_top             (ClutterActor *self);

    Raises self to the top.

    This function calls clutter_actor_raise() internally.

    +

    +

    @@ -3343,12 +3978,14 @@

    clutter_actor_lower_bottom ()

    -
    void                clutter_actor_lower_bottom          (ClutterActor *self);
    +
    void                clutter_actor_lower_bottom          (ClutterActor *self);

    Lowers self to the bottom.

    This function calls clutter_actor_lower() internally.

    +

    +

    @@ -3361,9 +3998,11 @@

    clutter_actor_get_stage ()

    -
    ClutterActor*       clutter_actor_get_stage             (ClutterActor *actor);
    +
    ClutterActor*       clutter_actor_get_stage             (ClutterActor *actor);

    Retrieves the ClutterStage where actor is contained.

    +

    +

    @@ -3374,7 +4013,7 @@ - +

    Returns :

    the stage containing the actor, or NULL. transfer none. the stage containing the actor, or NULL. transfer none.
    @@ -3383,7 +4022,7 @@

    clutter_actor_push_internal ()

    -
    void                clutter_actor_push_internal         (ClutterActor *self);
    +
    void                clutter_actor_push_internal         (ClutterActor *self);

    Should be used by actors implementing the ClutterContainer and with internal children added through clutter_actor_set_parent(), for instance: @@ -3434,6 +4073,8 @@

    Nested calls to clutter_actor_push_internal() are allowed, but each one must by followed by a clutter_actor_pop_internal() call.

    +

    +

    @@ -3447,9 +4088,11 @@

    clutter_actor_pop_internal ()

    -
    void                clutter_actor_pop_internal          (ClutterActor *self);
    +
    void                clutter_actor_pop_internal          (ClutterActor *self);

    Disables the effects of clutter_actor_pop_internal()

    +

    +

    @@ -3463,14 +4106,18 @@

    clutter_actor_set_depth ()

    -
    void                clutter_actor_set_depth             (ClutterActor *self,
    -                                                         gfloat depth);
    +
    void                clutter_actor_set_depth             (ClutterActor *self,
    +                                                         gfloat depth);

    Sets the Z coordinate of self to depth.

    The unit used by depth is dependant on the perspective setup. See also clutter_stage_set_perspective().

    +

    +

    @@ -3490,9 +4137,13 @@

    clutter_actor_get_depth ()

    -
    gfloat              clutter_actor_get_depth             (ClutterActor *self);
    +
    gfloat              clutter_actor_get_depth             (ClutterActor *self);

    Retrieves the depth of self.

    +

    +

    @@ -3512,13 +4163,19 @@

    clutter_actor_set_scale ()

    -
    void                clutter_actor_set_scale             (ClutterActor *self,
    -                                                         gdouble scale_x,
    -                                                         gdouble scale_y);
    +
    void                clutter_actor_set_scale             (ClutterActor *self,
    +                                                         gdouble scale_x,
    +                                                         gdouble scale_y);

    Scales an actor with the given factors. The scaling is relative to the scale center and the anchor point. The scale center is unchanged by this function and defaults to 0,0.

    +

    +

    @@ -3544,15 +4201,25 @@

    clutter_actor_set_scale_full ()

    -
    void                clutter_actor_set_scale_full        (ClutterActor *self,
    -                                                         gdouble scale_x,
    -                                                         gdouble scale_y,
    -                                                         gfloat center_x,
    -                                                         gfloat center_y);
    +
    void                clutter_actor_set_scale_full        (ClutterActor *self,
    +                                                         gdouble scale_x,
    +                                                         gdouble scale_y,
    +                                                         gfloat center_x,
    +                                                         gfloat center_y);

    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).

    +

    +

    @@ -3588,17 +4255,23 @@

    clutter_actor_set_scale_with_gravity ()

    -
    void                clutter_actor_set_scale_with_gravity
    -                                                        (ClutterActor *self,
    -                                                         gdouble scale_x,
    -                                                         gdouble scale_y,
    -                                                         ClutterGravity gravity);
    +
    void                clutter_actor_set_scale_with_gravity
    +                                                        (ClutterActor *self,
    +                                                         gdouble scale_x,
    +                                                         gdouble scale_y,
    +                                                         ClutterGravity gravity);

    Scales an actor with the given factors around the given center point. The center point is specified as one of the compass directions in ClutterGravity. For example, setting it to north will cause the top of the actor to remain unchanged and the rest of the actor to expand left, right and downwards.

    +

    +

    @@ -3630,11 +4303,17 @@

    clutter_actor_get_scale ()

    -
    void                clutter_actor_get_scale             (ClutterActor *self,
    -                                                         gdouble *scale_x,
    -                                                         gdouble *scale_y);
    +
    void                clutter_actor_get_scale             (ClutterActor *self,
    +                                                         gdouble *scale_x,
    +                                                         gdouble *scale_y);

    Retrieves an actors scale factors.

    +

    +

    @@ -3645,11 +4324,11 @@ - + - +

    scale_x :

    out) (allow-none. out. allow-none. out) (allow-none. out. allow-none.

    scale_y :

    out) (allow-none. out. allow-none. out) (allow-none. out. allow-none.
    @@ -3658,14 +4337,20 @@

    clutter_actor_get_scale_center ()

    -
    void                clutter_actor_get_scale_center      (ClutterActor *self,
    -                                                         gfloat *center_x,
    -                                                         gfloat *center_y);
    +
    void                clutter_actor_get_scale_center      (ClutterActor *self,
    +                                                         gfloat *center_x,
    +                                                         gfloat *center_y);

    Retrieves the scale center coordinate in pixels relative to the top left corner of the actor. If the scale center was specified using a ClutterGravity this will calculate the pixel offset using the current size of the actor.

    +

    +

    @@ -3676,11 +4361,11 @@ - + - +

    center_x :

    out) (allow-none. out. allow-none. out) (allow-none. out. allow-none.

    center_y :

    out) (allow-none. out. allow-none. out) (allow-none. out. allow-none.
    @@ -3689,11 +4374,13 @@

    clutter_actor_get_scale_gravity ()

    -
    ClutterGravity      clutter_actor_get_scale_gravity     (ClutterActor *self);
    +
    ClutterGravity      clutter_actor_get_scale_gravity     (ClutterActor *self);

    Retrieves the scale center as a compass direction. If the scale center was specified in pixels or units this will return -CLUTTER_GRAVITY_NONE.

    +CLUTTER_GRAVITY_NONE.

    +

    +

    @@ -3715,9 +4402,13 @@

    clutter_actor_is_scaled ()

    -
    gboolean            clutter_actor_is_scaled             (ClutterActor *self);
    +
    gboolean            clutter_actor_is_scaled             (ClutterActor *self);

    Checks whether the actor is scaled in either dimension.

    +

    +

    @@ -3728,7 +4419,7 @@ - @@ -3739,14 +4430,16 @@

    clutter_actor_apply_transform_to_point ()

    -
    void                clutter_actor_apply_transform_to_point
    -                                                        (ClutterActor *self,
    -                                                         const ClutterVertex *point,
    -                                                         ClutterVertex *vertex);
    +
    void                clutter_actor_apply_transform_to_point
    +                                                        (ClutterActor *self,
    +                                                         const ClutterVertex *point,
    +                                                         ClutterVertex *vertex);

    Transforms point in coordinates relative to the actor into screen-relative coordinates with the current actor transformation (i.e. scale, rotation, etc)

    +

    +

    Returns :

    TRUE if the actor is scaled. + TRUE if the actor is scaled.
    @@ -3772,11 +4465,21 @@

    clutter_actor_transform_stage_point ()

    -
    gboolean            clutter_actor_transform_stage_point (ClutterActor *self,
    -                                                         gfloat x,
    -                                                         gfloat y,
    -                                                         gfloat *x_out,
    -                                                         gfloat *y_out);
    +
    gboolean            clutter_actor_transform_stage_point (ClutterActor *self,
    +                                                         gfloat x,
    +                                                         gfloat y,
    +                                                         gfloat *x_out,
    +                                                         gfloat *y_out);

    This function translates screen coordinates (x, y) to coordinates relative to the actor. For example, it can be used to translate @@ -3797,6 +4500,8 @@

    Note: This function only works when the allocation is up-to-date, i.e. inside of paint()

    +

    +

    @@ -3807,23 +4512,23 @@ - + - + - + - + - @@ -3834,21 +4539,23 @@

    clutter_actor_apply_relative_transform_to_point ()

    -
    void                clutter_actor_apply_relative_transform_to_point
    -                                                        (ClutterActor *self,
    -                                                         ClutterActor *ancestor,
    -                                                         const ClutterVertex *point,
    -                                                         ClutterVertex *vertex);
    +
    void                clutter_actor_apply_relative_transform_to_point
    +                                                        (ClutterActor *self,
    +                                                         ClutterActor *ancestor,
    +                                                         const ClutterVertex *point,
    +                                                         ClutterVertex *vertex);

    Transforms point in coordinates relative to the actor into ancestor-relative coordinates using the relevant transform stack (i.e. scale, rotation, etc).

    -If ancestor is NULL the ancestor will be the ClutterStage. In +If ancestor is NULL the ancestor will be the ClutterStage. In this case, the coordinates returned will be the coordinates on the stage before the projection is applied. This is different from the behaviour of clutter_actor_apply_transform_to_point().

    +

    +

    x :

    x screen coordinate of the point to unproject. in. x screen coordinate of the point to unproject. in.

    y :

    y screen coordinate of the point to unproject. in. y screen coordinate of the point to unproject. in.

    x_out :

    return location for the unprojected x coordinance. out. return location for the unprojected x coordinance. out.

    y_out :

    return location for the unprojected y coordinance. out. return location for the unprojected y coordinance. out.

    Returns :

    TRUE if conversion was successful. + TRUE if conversion was successful.
    @@ -3859,7 +4566,7 @@ - + @@ -3878,12 +4585,18 @@

    clutter_actor_get_transformed_position ()

    -
    void                clutter_actor_get_transformed_position
    -                                                        (ClutterActor *self,
    -                                                         gfloat *x,
    -                                                         gfloat *y);
    +
    void                clutter_actor_get_transformed_position
    +                                                        (ClutterActor *self,
    +                                                         gfloat *x,
    +                                                         gfloat *y);

    Gets the absolute position of an actor, in pixels relative to the stage.

    +

    +

    ancestor :

    allow-none. allow-none. allow-none. allow-none.

    point :

    @@ -3894,11 +4607,11 @@ - + - +

    x :

    return location for the X coordinate, or NULL. out. allow-none. return location for the X coordinate, or NULL. out. allow-none.

    y :

    return location for the Y coordinate, or NULL. out. allow-none. return location for the Y coordinate, or NULL. out. allow-none.
    @@ -3907,9 +4620,13 @@

    clutter_actor_get_transformed_size ()

    -
    void                clutter_actor_get_transformed_size  (ClutterActor *self,
    -                                                         gfloat *width,
    -                                                         gfloat *height);
    +
    void                clutter_actor_get_transformed_size  (ClutterActor *self,
    +                                                         gfloat *width,
    +                                                         gfloat *height);

    Gets the absolute size of an actor in pixels, taking into account the scaling factors. @@ -3935,6 +4652,8 @@ returned by clutter_actor_get_transformed_position(); if you need this information, you need to use clutter_actor_get_abs_allocation_vertices() to get the coords of the actual quadrangle.

    +

    +

    @@ -3945,11 +4664,11 @@ - + - +

    width :

    return location for the width, or NULL. out. allow-none. return location for the width, or NULL. out. allow-none.

    height :

    return location for the height, or NULL. out. allow-none. return location for the height, or NULL. out. allow-none.
    @@ -3958,7 +4677,9 @@

    clutter_actor_get_paint_opacity ()

    -
    guint8              clutter_actor_get_paint_opacity     (ClutterActor *self);
    +
    guint8              clutter_actor_get_paint_opacity     (ClutterActor *self);

    Retrieves the absolute opacity of the actor, as it appears on the stage.

    @@ -3969,6 +4690,8 @@

    This function is intended for subclasses to use in the paint virtual function, to paint themselves with the correct opacity.

    +

    +

    @@ -3990,13 +4713,17 @@

    clutter_actor_get_paint_visibility ()

    -
    gboolean            clutter_actor_get_paint_visibility  (ClutterActor *self);
    +
    gboolean            clutter_actor_get_paint_visibility  (ClutterActor *self);

    Retrieves the 'paint' visibility of an actor recursively checking for non visible parents.

    -This is by definition the same as CLUTTER_ACTOR_IS_MAPPED().

    +This is by definition the same as CLUTTER_ACTOR_IS_MAPPED().

    +

    +

    @@ -4018,9 +4745,9 @@

    clutter_actor_get_abs_allocation_vertices ()

    -
    void                clutter_actor_get_abs_allocation_vertices
    -                                                        (ClutterActor *self,
    -                                                         ClutterVertex verts[]);
    +
    void                clutter_actor_get_abs_allocation_vertices
    +                                                        (ClutterActor *self,
    +                                                         ClutterVertex verts[]);

    Calculates the transformed screen coordinates of the four corners of the actor; the returned vertices relate to the ClutterActorBox @@ -4032,6 +4759,8 @@

  • v[2] contains (x1, y2)

  • v[3] contains (x2, y2)

  • +

    +

    @@ -4042,7 +4771,7 @@ - +

    verts :

    out) (array fixed-size=4. out. array fixed-size=4. out) (array fixed-size=4. out. array fixed-size=4.
    @@ -4051,11 +4780,15 @@

    clutter_actor_get_transformation_matrix ()

    -
    void                clutter_actor_get_transformation_matrix
    -                                                        (ClutterActor *self,
    -                                                         CoglMatrix *matrix);
    +
    void                clutter_actor_get_transformation_matrix
    +                                                        (ClutterActor *self,
    +                                                         CoglMatrix *matrix);

    Retrieves the transformations applied to self

    +

    +

    @@ -4066,7 +4799,9 @@ - +

    matrix :

    the return location for a CoglMatrix. out. the return location for a CoglMatrix. out.
    @@ -4075,14 +4810,20 @@

    clutter_actor_set_anchor_point ()

    -
    void                clutter_actor_set_anchor_point      (ClutterActor *self,
    -                                                         gfloat anchor_x,
    -                                                         gfloat anchor_y);
    +
    void                clutter_actor_set_anchor_point      (ClutterActor *self,
    +                                                         gfloat anchor_x,
    +                                                         gfloat anchor_y);

    Sets an anchor point for self. The anchor point is a point in the coordinate space of an actor to which the actor position within its parent is relative; the default is (0, 0), i.e. the top-left corner of the actor.

    +

    +

    @@ -4108,11 +4849,17 @@

    clutter_actor_get_anchor_point ()

    -
    void                clutter_actor_get_anchor_point      (ClutterActor *self,
    -                                                         gfloat *anchor_x,
    -                                                         gfloat *anchor_y);
    +
    void                clutter_actor_get_anchor_point      (ClutterActor *self,
    +                                                         gfloat *anchor_x,
    +                                                         gfloat *anchor_y);

    Gets the current anchor point of the actor in pixels.

    +

    +

    @@ -4123,11 +4870,11 @@ - + - +

    anchor_x :

    return location for the X coordinate of the anchor point. out. return location for the X coordinate of the anchor point. out.

    anchor_y :

    return location for the Y coordinate of the anchor point. out. return location for the Y coordinate of the anchor point. out.
    @@ -4136,9 +4883,9 @@

    clutter_actor_set_anchor_point_from_gravity ()

    -
    void                clutter_actor_set_anchor_point_from_gravity
    -                                                        (ClutterActor *self,
    -                                                         ClutterGravity gravity);
    +
    void                clutter_actor_set_anchor_point_from_gravity
    +                                                        (ClutterActor *self,
    +                                                         ClutterGravity gravity);

    Sets an anchor point on the actor, based on the given gravity (this is a convenience function wrapping clutter_actor_set_anchor_point()). @@ -4146,9 +4893,11 @@

    Since version 1.0 the anchor point will be stored as a gravity so that if the actor changes size then the anchor point will move. For -example, if you set the anchor point to CLUTTER_GRAVITY_SOUTH_EAST +example, if you set the anchor point to CLUTTER_GRAVITY_SOUTH_EAST and later double the size of the actor, the anchor point will move to the bottom right.

    +

    +

    @@ -4169,12 +4918,14 @@

    clutter_actor_get_anchor_point_gravity ()

    -
    ClutterGravity      clutter_actor_get_anchor_point_gravity
    -                                                        (ClutterActor *self);
    +
    ClutterGravity      clutter_actor_get_anchor_point_gravity
    +                                                        (ClutterActor *self);

    Retrieves the anchor position expressed as a ClutterGravity. If the anchor point was specified using pixels or units this will -return CLUTTER_GRAVITY_NONE.

    +return CLUTTER_GRAVITY_NONE.

    +

    +

    @@ -4196,12 +4947,18 @@

    clutter_actor_move_anchor_point ()

    -
    void                clutter_actor_move_anchor_point     (ClutterActor *self,
    -                                                         gfloat anchor_x,
    -                                                         gfloat anchor_y);
    +
    void                clutter_actor_move_anchor_point     (ClutterActor *self,
    +                                                         gfloat anchor_x,
    +                                                         gfloat anchor_y);

    Sets an anchor point for the actor, and adjusts the actor postion so that the relative position of the actor toward its parent remains the same.

    +

    +

    @@ -4227,9 +4984,9 @@

    clutter_actor_move_anchor_point_from_gravity ()

    -
    void                clutter_actor_move_anchor_point_from_gravity
    -                                                        (ClutterActor *self,
    -                                                         ClutterGravity gravity);
    +
    void                clutter_actor_move_anchor_point_from_gravity
    +                                                        (ClutterActor *self,
    +                                                         ClutterGravity gravity);

    Sets an anchor point on the actor based on the given gravity, adjusting the actor postion so that its relative position within its parent remains @@ -4238,9 +4995,11 @@

    Since version 1.0 the anchor point will be stored as a gravity so that if the actor changes size then the anchor point will move. For -example, if you set the anchor point to CLUTTER_GRAVITY_SOUTH_EAST +example, if you set the anchor point to CLUTTER_GRAVITY_SOUTH_EAST and later double the size of the actor, the anchor point will move to the bottom right.

    +

    +

    @@ -4261,10 +5020,14 @@

    clutter_actor_set_reactive ()

    -
    void                clutter_actor_set_reactive          (ClutterActor *actor,
    -                                                         gboolean reactive);
    +
    void                clutter_actor_set_reactive          (ClutterActor *actor,
    +                                                         gboolean reactive);

    Sets actor as reactive. Reactive actors will receive events.

    +

    +

    @@ -4285,9 +5048,13 @@

    clutter_actor_get_reactive ()

    -
    gboolean            clutter_actor_get_reactive          (ClutterActor *actor);
    +
    gboolean            clutter_actor_get_reactive          (ClutterActor *actor);

    Checks whether actor is marked as reactive.

    +

    +

    @@ -4298,7 +5065,7 @@ - @@ -4309,14 +5076,18 @@

    clutter_actor_set_shader ()

    -
    gboolean            clutter_actor_set_shader            (ClutterActor *self,
    -                                                         ClutterShader *shader);
    +
    gboolean            clutter_actor_set_shader            (ClutterActor *self,
    +                                                         ClutterShader *shader);

    Sets the ClutterShader to be used when rendering self.

    -If shader is NULL it will unset any currently set shader +If shader is NULL it will unset any currently set shader for the actor.

    +

    +

    Returns :

    TRUE if the actor is reactive + TRUE if the actor is reactive
    @@ -4327,11 +5098,11 @@ - + - @@ -4342,9 +5113,11 @@

    clutter_actor_get_shader ()

    -
    ClutterShader *     clutter_actor_get_shader            (ClutterActor *self);
    +
    ClutterShader *     clutter_actor_get_shader            (ClutterActor *self);

    Queries the currently set ClutterShader on self.

    +

    +

    shader :

    a ClutterShader or NULL to unset the shader.. allow-none. a ClutterShader or NULL to unset the shader.. allow-none.

    Returns :

    TRUE if the shader was successfully applied + TRUE if the shader was successfully applied
    @@ -4355,7 +5128,7 @@ - +

    Returns :

    transfer none. transfer none. transfer none. transfer none.
    @@ -4364,12 +5137,18 @@

    clutter_actor_set_shader_param ()

    -
    void                clutter_actor_set_shader_param      (ClutterActor *self,
    -                                                         const gchar *param,
    -                                                         const GValue *value);
    +
    void                clutter_actor_set_shader_param      (ClutterActor *self,
    +                                                         const gchar *param,
    +                                                         const GValue *value);

    Sets the value for a named parameter of the shader applied to actor.

    +

    +

    @@ -4395,13 +5174,19 @@

    clutter_actor_set_shader_param_float ()

    -
    void                clutter_actor_set_shader_param_float
    -                                                        (ClutterActor *self,
    -                                                         const gchar *param,
    -                                                         gfloat value);
    +
    void                clutter_actor_set_shader_param_float
    +                                                        (ClutterActor *self,
    +                                                         const gchar *param,
    +                                                         gfloat value);

    Sets the value for a named float parameter of the shader applied to actor.

    +

    +

    @@ -4427,12 +5212,18 @@

    clutter_actor_set_shader_param_int ()

    -
    void                clutter_actor_set_shader_param_int  (ClutterActor *self,
    -                                                         const gchar *param,
    -                                                         gint value);
    +
    void                clutter_actor_set_shader_param_int  (ClutterActor *self,
    +                                                         const gchar *param,
    +                                                         gint value);

    Sets the value for a named int parameter of the shader applied to actor.

    +

    +

    @@ -4458,10 +5249,12 @@

    clutter_actor_grab_key_focus ()

    -
    void                clutter_actor_grab_key_focus        (ClutterActor *self);
    +
    void                clutter_actor_grab_key_focus        (ClutterActor *self);

    Sets the key focus of the ClutterStage including self to this ClutterActor.

    +

    +

    @@ -4475,9 +5268,15 @@

    clutter_actor_get_pango_context ()

    -
    PangoContext *      clutter_actor_get_pango_context     (ClutterActor *self);
    -

    -Retrieves the PangoContext for self. The actor's PangoContext +

    PangoContext *      clutter_actor_get_pango_context     (ClutterActor *self);
    +

    +Retrieves the PangoContext for self. The actor's PangoContext is already configured using the appropriate font map, resolution and font options.

    @@ -4487,9 +5286,15 @@ stored by the ClutterBackend change.

    -You can use the returned PangoContext to create a PangoLayout +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.

    +

    +

    @@ -4500,7 +5305,7 @@ - +

    Returns :

    transfer none. transfer none. transfer none. transfer none.
    @@ -4509,14 +5314,22 @@

    clutter_actor_create_pango_context ()

    -
    PangoContext *      clutter_actor_create_pango_context  (ClutterActor *self);
    -

    -Creates a PangoContext for the given actor. The PangoContext +

    PangoContext *      clutter_actor_create_pango_context  (ClutterActor *self);
    +

    +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().

    +

    +

    @@ -4527,7 +5340,11 @@ - @@ -4539,19 +5356,35 @@

    clutter_actor_create_pango_layout ()

    -
    PangoLayout *       clutter_actor_create_pango_layout   (ClutterActor *self,
    -                                                         const gchar *text);
    -

    -Creates a new PangoLayout from the same PangoContext used -by the ClutterActor. The PangoLayout is already configured +

    PangoLayout *       clutter_actor_create_pango_layout   (ClutterActor *self,
    +                                                         const gchar *text);
    +

    +Creates a new PangoLayout from the same PangoContext used +by the ClutterActor. The PangoLayout is already configured with the font map, resolution and font options, and the given text.

    -If you want to keep around a PangoLayout created by this +If you want to keep around a PangoLayout created by this function you will have to connect to the "font-changed" and "resolution-changed" signals, and call -pango_layout_context_changed() in response to them.

    +pango_layout_context_changed() in response to them.

    +

    +

    Returns :

    the newly created PangoContext. Use g_object_unref() + the newly created PangoContext. Use g_object_unref() on the returned value to deallocate its resources
    @@ -4562,12 +5395,18 @@ - - @@ -4579,7 +5418,9 @@

    clutter_actor_is_in_clone_paint ()

    -
    gboolean            clutter_actor_is_in_clone_paint     (ClutterActor *self);
    +
    gboolean            clutter_actor_is_in_clone_paint     (ClutterActor *self);

    Checks whether self is being currently painted by a ClutterClone

    @@ -4590,6 +5431,8 @@

    This function should not be used by applications

    +

    +

    text :

    (allow-none) the text to set on the PangoLayout, or NULL + (allow-none) the text to set on the PangoLayout, or NULL

    Returns :

    the newly created PangoLayout. Use g_object_unref() + the newly created PangoLayout. Use g_object_unref() when done
    @@ -4600,8 +5443,8 @@ - @@ -4612,13 +5455,13 @@

    clutter_actor_set_text_direction ()

    -
    void                clutter_actor_set_text_direction    (ClutterActor *self,
    -                                                         ClutterTextDirection text_dir);
    +
    void                clutter_actor_set_text_direction    (ClutterActor *self,
    +                                                         ClutterTextDirection text_dir);

    Sets the ClutterTextDirection for an actor

    -The passed text direction must not be CLUTTER_TEXT_DIRECTION_DEFAULT +The passed text direction must not be CLUTTER_TEXT_DIRECTION_DEFAULT

    If self implements ClutterContainer then this function will recurse @@ -4627,7 +5470,11 @@

    Composite actors not implementing ClutterContainer, or actors requiring special handling when the text direction changes, should connect to -the "notify" signal for the "text-direction" property

    +the "notify" signal for the "text-direction" property

    +

    +

    Returns :

    TRUE if the ClutterActor is currently being painted - by a ClutterClone, and FALSE otherwise + TRUE if the ClutterActor is currently being painted + by a ClutterClone, and FALSE otherwise
    @@ -4648,7 +5495,7 @@

    clutter_actor_get_text_direction ()

    -
    ClutterTextDirection  clutter_actor_get_text_direction  (ClutterActor *self);
    +
    ClutterTextDirection  clutter_actor_get_text_direction  (ClutterActor *self);

    Retrieves the value set using clutter_actor_set_text_direction()

    @@ -4656,6 +5503,8 @@ If no text direction has been previously set, the default text direction, as returned by clutter_get_default_text_direction(), will be returned instead

    +

    +

    @@ -4677,10 +5526,14 @@

    clutter_actor_has_pointer ()

    -
    gboolean            clutter_actor_has_pointer           (ClutterActor *self);
    +
    gboolean            clutter_actor_has_pointer           (ClutterActor *self);

    Checks whether an actor contains the the pointer of a ClutterInputDevice

    +

    +

    @@ -4691,8 +5544,8 @@ - @@ -4715,26 +5568,36 @@ Bounding box of an actor. The coordinates of the top left and right bottom corners of an actor. The coordinates of the two points are expressed in pixels with sub-pixel precision

    +

    +

    Returns :

    TRUE if the actor contains the pointer, and - FALSE otherwise + TRUE if the actor contains the pointer, and + FALSE otherwise
    - + - + - + - + @@ -4744,13 +5607,23 @@

    clutter_actor_box_new ()

    -
    ClutterActorBox *   clutter_actor_box_new               (gfloat x_1,
    -                                                         gfloat y_1,
    -                                                         gfloat x_2,
    -                                                         gfloat y_2);
    +
    ClutterActorBox *   clutter_actor_box_new               (gfloat x_1,
    +                                                         gfloat y_1,
    +                                                         gfloat x_2,
    +                                                         gfloat y_2);

    Allocates a new ClutterActorBox using the passed coordinates for the top left and bottom right points

    +

    +

    gfloat x1;

    gfloat x1;

    X coordinate of the top left corner

    gfloat y1;

    gfloat y1;

    Y coordinate of the top left corner

    gfloat x2;

    gfloat x2;

    X coordinate of the bottom right corner

    gfloat y2;

    gfloat y2;

    Y coordinate of the bottom right corner
    @@ -4788,9 +5661,11 @@

    clutter_actor_box_copy ()

    -
    ClutterActorBox *   clutter_actor_box_copy              (const ClutterActorBox *box);
    +
    ClutterActorBox *   clutter_actor_box_copy              (const ClutterActorBox *box);

    Copies box

    +

    +

    @@ -4813,10 +5688,12 @@

    clutter_actor_box_free ()

    -
    void                clutter_actor_box_free              (ClutterActorBox *box);
    +
    void                clutter_actor_box_free              (ClutterActorBox *box);

    Frees a ClutterActorBox allocated using clutter_actor_box_new() or clutter_actor_box_copy()

    +

    +

    @@ -4830,10 +5707,14 @@

    clutter_actor_box_equal ()

    -
    gboolean            clutter_actor_box_equal             (const ClutterActorBox *box_a,
    -                                                         const ClutterActorBox *box_b);
    +
    gboolean            clutter_actor_box_equal             (const ClutterActorBox *box_a,
    +                                                         const ClutterActorBox *box_b);

    Checks box_a and box_b for equality

    +

    +

    @@ -4849,7 +5730,7 @@ - @@ -4860,9 +5741,13 @@

    clutter_actor_box_get_x ()

    -
    gfloat              clutter_actor_box_get_x             (const ClutterActorBox *box);
    +
    gfloat              clutter_actor_box_get_x             (const ClutterActorBox *box);

    Retrieves the X coordinate of the origin of box

    +

    +

    Returns :

    TRUE if the passed ClutterActorBox are equal + TRUE if the passed ClutterActorBox are equal
    @@ -4884,9 +5769,13 @@

    clutter_actor_box_get_y ()

    -
    gfloat              clutter_actor_box_get_y             (const ClutterActorBox *box);
    +
    gfloat              clutter_actor_box_get_y             (const ClutterActorBox *box);

    Retrieves the Y coordinate of the origin of box

    +

    +

    @@ -4908,9 +5797,13 @@

    clutter_actor_box_get_width ()

    -
    gfloat              clutter_actor_box_get_width         (const ClutterActorBox *box);
    +
    gfloat              clutter_actor_box_get_width         (const ClutterActorBox *box);

    Retrieves the width of the box

    +

    +

    @@ -4932,9 +5825,13 @@

    clutter_actor_box_get_height ()

    -
    gfloat              clutter_actor_box_get_height        (const ClutterActorBox *box);
    +
    gfloat              clutter_actor_box_get_height        (const ClutterActorBox *box);

    Retrieves the height of the box

    +

    +

    @@ -4956,11 +5853,17 @@

    clutter_actor_box_get_origin ()

    -
    void                clutter_actor_box_get_origin        (const ClutterActorBox *box,
    -                                                         gfloat *x,
    -                                                         gfloat *y);
    +
    void                clutter_actor_box_get_origin        (const ClutterActorBox *box,
    +                                                         gfloat *x,
    +                                                         gfloat *y);

    Retrieves the origin of box

    +

    +

    @@ -4971,11 +5874,11 @@ - + - +

    x :

    return location for the X coordinate, or NULL. out. allow-none. return location for the X coordinate, or NULL. out. allow-none.

    y :

    return location for the Y coordinate, or NULL. out. allow-none. return location for the Y coordinate, or NULL. out. allow-none.
    @@ -4984,11 +5887,17 @@

    clutter_actor_box_get_size ()

    -
    void                clutter_actor_box_get_size          (const ClutterActorBox *box,
    -                                                         gfloat *width,
    -                                                         gfloat *height);
    +
    void                clutter_actor_box_get_size          (const ClutterActorBox *box,
    +                                                         gfloat *width,
    +                                                         gfloat *height);

    Retrieves the size of box

    +

    +

    @@ -4999,11 +5908,11 @@ - + - +

    width :

    return location for the width, or NULL. out. allow-none. return location for the width, or NULL. out. allow-none.

    height :

    return location for the height, or NULL. out. allow-none. return location for the height, or NULL. out. allow-none.
    @@ -5012,9 +5921,13 @@

    clutter_actor_box_get_area ()

    -
    gfloat              clutter_actor_box_get_area          (const ClutterActorBox *box);
    +
    gfloat              clutter_actor_box_get_area          (const ClutterActorBox *box);

    Retrieves the area of box

    +

    +

    @@ -5036,12 +5949,20 @@

    clutter_actor_box_contains ()

    -
    gboolean            clutter_actor_box_contains          (const ClutterActorBox *box,
    -                                                         gfloat x,
    -                                                         gfloat y);
    +
    gboolean            clutter_actor_box_contains          (const ClutterActorBox *box,
    +                                                         gfloat x,
    +                                                         gfloat y);

    Checks whether a point with x, y coordinates is contained withing box

    +

    +

    @@ -5062,7 +5983,7 @@ - @@ -5073,11 +5994,13 @@

    clutter_actor_box_from_vertices ()

    -
    void                clutter_actor_box_from_vertices     (ClutterActorBox *box,
    -                                                         const ClutterVertex verts[]);
    +
    void                clutter_actor_box_from_vertices     (ClutterActorBox *box,
    +                                                         const ClutterVertex verts[]);

    Calculates the bounding box represented by the four vertices; for details of the vertex array see clutter_actor_get_abs_allocation_vertices().

    +

    +

    Returns :

    TRUE if the point is contained by the ClutterActorBox + TRUE if the point is contained by the ClutterActorBox
    @@ -5097,14 +6020,16 @@

    clutter_actor_box_clamp_to_pixel ()

    -
    void                clutter_actor_box_clamp_to_pixel    (ClutterActorBox *box);
    +
    void                clutter_actor_box_clamp_to_pixel    (ClutterActorBox *box);

    Clamps the components of box to the nearest integer

    +

    +

    - +

    box :

    the ClutterActorBox to clamp. inout. the ClutterActorBox to clamp. inout.

    Since 1.2

    @@ -5112,13 +6037,17 @@

    clutter_actor_box_interpolate ()

    -
    void                clutter_actor_box_interpolate       (const ClutterActorBox *initial,
    -                                                         const ClutterActorBox *final,
    -                                                         gdouble progress,
    -                                                         ClutterActorBox *result);
    +
    void                clutter_actor_box_interpolate       (const ClutterActorBox *initial,
    +                                                         const ClutterActorBox *final,
    +                                                         gdouble progress,
    +                                                         ClutterActorBox *result);

    Interpolates between initial and final ClutterActorBoxes using progress

    +

    +

    @@ -5139,7 +6068,7 @@ - +

    result :

    return location for the interpolation. out. return location for the interpolation. out.
    @@ -5156,21 +6085,29 @@

    Vertex of an actor in 3D space, expressed in pixels

    +

    +

    - + - + - + @@ -5181,12 +6118,20 @@

    clutter_vertex_new ()

    -
    ClutterVertex *     clutter_vertex_new                  (gfloat x,
    -                                                         gfloat y,
    -                                                         gfloat z);
    +
    ClutterVertex *     clutter_vertex_new                  (gfloat x,
    +                                                         gfloat y,
    +                                                         gfloat z);

    Creates a new ClutterVertex for the point in 3D space identified by the 3 coordinates x, y, z

    +

    +

    gfloat x;

    gfloat x;

    X coordinate of the vertex

    gfloat y;

    gfloat y;

    Y coordinate of the vertex

    gfloat z;

    gfloat z;

    Z coordinate of the vertex
    @@ -5219,9 +6164,11 @@

    clutter_vertex_copy ()

    -
    ClutterVertex *     clutter_vertex_copy                 (const ClutterVertex *vertex);
    +
    ClutterVertex *     clutter_vertex_copy                 (const ClutterVertex *vertex);

    Copies vertex

    +

    +

    @@ -5244,9 +6191,11 @@

    clutter_vertex_free ()

    -
    void                clutter_vertex_free                 (ClutterVertex *vertex);
    +
    void                clutter_vertex_free                 (ClutterVertex *vertex);

    Frees a ClutterVertex allocated using clutter_vertex_copy()

    +

    +

    @@ -5260,10 +6209,14 @@

    clutter_vertex_equal ()

    -
    gboolean            clutter_vertex_equal                (const ClutterVertex *vertex_a,
    -                                                         const ClutterVertex *vertex_b);
    +
    gboolean            clutter_vertex_equal                (const ClutterVertex *vertex_a,
    +                                                         const ClutterVertex *vertex_b);

    Compares vertex_a and vertex_b for equality

    +

    +

    @@ -5279,7 +6232,7 @@ - @@ -5292,59 +6245,75 @@

    Property Details

    The "allocation" property

    -
      "allocation"               ClutterActorBox*      : Read
    +
      "allocation"               ClutterActorBox*      : Read

    The allocation for the actor, in pixels

    This is property is read-only, but you might monitor it to know when an actor moves or resizes

    -

    Since 0.8

    +

    +

    +

    Since 0.8


    The "anchor-gravity" property

    -
      "anchor-gravity"           ClutterGravity        : Read / Write
    +
      "anchor-gravity"           ClutterGravity        : Read / Write

    The anchor point expressed as a ClutterGravity

    +

    +

    Default value: CLUTTER_GRAVITY_NONE

    -

    Since 1.0

    +

    Since 1.0


    The "anchor-x" property

    -
      "anchor-x"                 gfloat                : Read / Write
    +
      "anchor-x"                 gfloat                : Read / Write

    The X coordinate of an actor's anchor point, relative to the actor coordinate space, in pixels

    +

    +

    Default value: 0

    -

    Since 0.8

    +

    Since 0.8


    The "anchor-y" property

    -
      "anchor-y"                 gfloat                : Read / Write
    +
      "anchor-y"                 gfloat                : Read / Write

    The Y coordinate of an actor's anchor point, relative to the actor coordinate space, in pixels

    +

    +

    Default value: 0

    -

    Since 0.8

    +

    Since 0.8


    The "clip" property

    -
      "clip"                     ClutterGeometry*      : Read / Write
    +
      "clip"                     ClutterGeometry*      : Read / Write

    The clip region for the actor, in actor-relative coordinates

    Every part of the actor outside the clip region will not be painted

    +

    +


    The "clip-to-allocation" property

    -
      "clip-to-allocation"       gboolean              : Read / Write
    +
      "clip-to-allocation"       gboolean              : Read / Write

    Whether the clip region should track the allocated area of the actor. @@ -5352,97 +6321,133 @@

    This property is ignored if a clip area has been explicitly set using clutter_actor_set_clip().

    +

    +

    Default value: FALSE

    -

    Since 1.0

    +

    Since 1.0


    The "depth" property

    -
      "depth"                    gfloat                : Read / Write
    +
      "depth"                    gfloat                : Read / Write

    The position of the actor on the Z axis

    +

    +

    Default value: 0

    -

    Since 0.6

    +

    Since 0.6


    The "fixed-position-set" property

    -
      "fixed-position-set"       gboolean              : Read / Write
    +
      "fixed-position-set"       gboolean              : Read / Write

    This flag controls whether the "fixed-x" and "fixed-y" properties are used

    +

    +

    Default value: FALSE

    -

    Since 0.8

    +

    Since 0.8


    The "fixed-x" property

    -
      "fixed-x"                  gfloat                : Read / Write
    +
      "fixed-x"                  gfloat                : Read / Write

    The fixed X position of the actor in pixels.

    Writing this property sets "fixed-position-set" property as well, as a side effect

    +

    +

    Default value: 0

    -

    Since 0.8

    +

    Since 0.8


    The "fixed-y" property

    -
      "fixed-y"                  gfloat                : Read / Write
    +
      "fixed-y"                  gfloat                : Read / Write

    The fixed Y position of the actor in pixels.

    Writing this property sets the "fixed-position-set" property as well, as a side effect

    +

    +

    Default value: 0

    -

    Since 0.8

    +

    Since 0.8


    The "has-clip" property

    -
      "has-clip"                 gboolean              : Read
    +
      "has-clip"                 gboolean              : Read

    Whether the actor has the "clip" property set or not

    +

    +

    Default value: FALSE


    The "has-pointer" property

    -
      "has-pointer"              gboolean              : Read
    +
      "has-pointer"              gboolean              : Read

    Whether the actor contains the pointer of a ClutterInputDevice or not.

    +

    +

    Default value: FALSE

    -

    Since 1.2

    +

    Since 1.2


    The "height" property

    -
      "height"                   gfloat                : Read / Write
    +
      "height"                   gfloat                : Read / Write

    Height of the actor (in pixels). If written, forces the minimum and natural size request of the actor to the given height. If read, returns the allocated height if available, otherwise the height request.

    +

    +

    Allowed values: >= 0

    Default value: 0


    The "mapped" property

    -
      "mapped"                   gboolean              : Read
    +
      "mapped"                   gboolean              : Read

    Whether the actor is mapped (will be painted when the stage to which it belongs is mapped)

    +

    +

    Default value: FALSE

    -

    Since 1.0

    +

    Since 1.0


    The "min-height" property

    -
      "min-height"               gfloat                : Read / Write
    +
      "min-height"               gfloat                : Read / Write

    A forced minimum height request for the actor, in pixels

    @@ -5450,24 +6455,32 @@ Writing this property sets the "min-height-set" property as well, as a side effect. This property overrides the usual height request of the actor.

    +

    +

    Allowed values: >= 0

    Default value: 0

    -

    Since 0.8

    +

    Since 0.8


    The "min-height-set" property

    -
      "min-height-set"           gboolean              : Read / Write
    +
      "min-height-set"           gboolean              : Read / Write

    This flag controls whether the "min-height" property is used

    +

    +

    Default value: FALSE

    -

    Since 0.8

    +

    Since 0.8


    The "min-width" property

    -
      "min-width"                gfloat                : Read / Write
    +
      "min-width"                gfloat                : Read / Write

    A forced minimum width request for the actor, in pixels

    @@ -5477,33 +6490,45 @@

    This property overrides the usual width request of the actor.

    +

    +

    Allowed values: >= 0

    Default value: 0

    -

    Since 0.8

    +

    Since 0.8


    The "min-width-set" property

    -
      "min-width-set"            gboolean              : Read / Write
    +
      "min-width-set"            gboolean              : Read / Write

    This flag controls whether the "min-width" property is used

    +

    +

    Default value: FALSE

    -

    Since 0.8

    +

    Since 0.8


    The "name" property

    -
      "name"                     gchar*                : Read / Write
    +
      "name"                     gchar*                : Read / Write

    The name of the actor

    +

    +

    Default value: NULL

    -

    Since 0.2

    +

    Since 0.2


    The "natural-height" property

    -
      "natural-height"           gfloat                : Read / Write
    +
      "natural-height"           gfloat                : Read / Write

    A forced natural height request for the actor, in pixels

    @@ -5511,24 +6536,32 @@ Writing this property sets the "natural-height-set" property as well, as a side effect. This property overrides the usual height request of the actor

    +

    +

    Allowed values: >= 0

    Default value: 0

    -

    Since 0.8

    +

    Since 0.8


    The "natural-height-set" property

    -
      "natural-height-set"       gboolean              : Read / Write
    +
      "natural-height-set"       gboolean              : Read / Write

    This flag controls whether the "natural-height" property is used

    +

    +

    Default value: FALSE

    -

    Since 0.8

    +

    Since 0.8


    The "natural-width" property

    -
      "natural-width"            gfloat                : Read / Write
    +
      "natural-width"            gfloat                : Read / Write

    A forced natural width request for the actor, in pixels

    @@ -5536,55 +6569,73 @@ Writing this property sets the "natural-width-set" property as well, as a side effect. This property overrides the usual width request of the actor

    +

    +

    Allowed values: >= 0

    Default value: 0

    -

    Since 0.8

    +

    Since 0.8


    The "natural-width-set" property

    -
      "natural-width-set"        gboolean              : Read / Write
    +
      "natural-width-set"        gboolean              : Read / Write

    This flag controls whether the "natural-width" property is used

    +

    +

    Default value: FALSE

    -

    Since 0.8

    +

    Since 0.8


    The "opacity" property

    -
      "opacity"                  guint                 : Read / Write
    +
      "opacity"                  guint                 : Read / Write

    Opacity of an actor, between 0 (fully transparent) and 255 (fully opaque)

    +

    +

    Allowed values: <= 255

    Default value: 255


    The "reactive" property

    -
      "reactive"                 gboolean              : Read / Write
    +
      "reactive"                 gboolean              : Read / Write

    Whether the actor is reactive to events or not

    Only reactive actors will emit event-related signals

    +

    +

    Default value: FALSE

    -

    Since 0.6

    +

    Since 0.6


    The "realized" property

    -
      "realized"                 gboolean              : Read
    +
      "realized"                 gboolean              : Read

    Whether the actor has been realized

    +

    +

    Default value: FALSE

    -

    Since 1.0

    +

    Since 1.0


    The "request-mode" property

    -
      "request-mode"             ClutterRequestMode    : Read / Write
    +
      "request-mode"             ClutterRequestMode    : Read / Write

    Request mode for the ClutterActor. The request mode determines the type of geometry management used by the actor, either height for width @@ -5636,176 +6687,236 @@

    The clutter_actor_get_preferred_size() function will implement this check for you.

    +

    +

    Default value: CLUTTER_REQUEST_HEIGHT_FOR_WIDTH

    -

    Since 0.8

    +

    Since 0.8


    The "rotation-angle-x" property

    -
      "rotation-angle-x"         gdouble               : Read / Write
    +
      "rotation-angle-x"         gdouble               : Read / Write

    The rotation angle on the X axis

    +

    +

    Default value: 0

    -

    Since 0.6

    +

    Since 0.6


    The "rotation-angle-y" property

    -
      "rotation-angle-y"         gdouble               : Read / Write
    +
      "rotation-angle-y"         gdouble               : Read / Write

    The rotation angle on the Y axis

    +

    +

    Default value: 0

    -

    Since 0.6

    +

    Since 0.6


    The "rotation-angle-z" property

    -
      "rotation-angle-z"         gdouble               : Read / Write
    +
      "rotation-angle-z"         gdouble               : Read / Write

    The rotation angle on the Z axis

    +

    +

    Default value: 0

    -

    Since 0.6

    +

    Since 0.6


    The "rotation-center-x" property

    -
      "rotation-center-x"        ClutterVertex*        : Read / Write
    +
      "rotation-center-x"        ClutterVertex*        : Read / Write

    The rotation center on the X axis.

    -

    Since 0.6

    +

    +

    +

    Since 0.6


    The "rotation-center-y" property

    -
      "rotation-center-y"        ClutterVertex*        : Read / Write
    +
      "rotation-center-y"        ClutterVertex*        : Read / Write

    The rotation center on the Y axis.

    -

    Since 0.6

    +

    +

    +

    Since 0.6


    The "rotation-center-z" property

    -
      "rotation-center-z"        ClutterVertex*        : Read / Write
    +
      "rotation-center-z"        ClutterVertex*        : Read / Write

    The rotation center on the Z axis.

    -

    Since 0.6

    +

    +

    +

    Since 0.6


    The "rotation-center-z-gravity" property

    -
      "rotation-center-z-gravity" ClutterGravity        : Read / Write
    +
      "rotation-center-z-gravity" ClutterGravity        : Read / Write

    The rotation center on the Z axis expressed as a ClutterGravity.

    +

    +

    Default value: CLUTTER_GRAVITY_NONE

    -

    Since 1.0

    +

    Since 1.0


    The "scale-center-x" property

    -
      "scale-center-x"           gfloat                : Read / Write
    +
      "scale-center-x"           gfloat                : Read / Write

    The horizontal center point for scaling

    +

    +

    Default value: 0

    -

    Since 1.0

    +

    Since 1.0


    The "scale-center-y" property

    -
      "scale-center-y"           gfloat                : Read / Write
    +
      "scale-center-y"           gfloat                : Read / Write

    The vertical center point for scaling

    +

    +

    Default value: 0

    -

    Since 1.0

    +

    Since 1.0


    The "scale-gravity" property

    -
      "scale-gravity"            ClutterGravity        : Read / Write
    +
      "scale-gravity"            ClutterGravity        : Read / Write

    The center point for scaling expressed as a ClutterGravity

    +

    +

    Default value: CLUTTER_GRAVITY_NONE

    -

    Since 1.0

    +

    Since 1.0


    The "scale-x" property

    -
      "scale-x"                  gdouble               : Read / Write
    +
      "scale-x"                  gdouble               : Read / Write

    The horizontal scale of the actor

    +

    +

    Allowed values: >= 0

    Default value: 1

    -

    Since 0.6

    +

    Since 0.6


    The "scale-y" property

    -
      "scale-y"                  gdouble               : Read / Write
    +
      "scale-y"                  gdouble               : Read / Write

    The vertical scale of the actor

    +

    +

    Allowed values: >= 0

    Default value: 1

    -

    Since 0.6

    +

    Since 0.6


    The "show-on-set-parent" property

    -
      "show-on-set-parent"       gboolean              : Read / Write
    +
      "show-on-set-parent"       gboolean              : Read / Write

    -If TRUE, the actor is automatically shown when parented. +If TRUE, the actor is automatically shown when parented.

    Calling clutter_actor_hide() on an actor which has not been -parented will set this property to FALSE as a side effect.

    +parented will set this property to FALSE as a side effect.

    +

    +

    Default value: TRUE

    -

    Since 0.8

    +

    Since 0.8


    The "text-direction" property

    -
      "text-direction"           ClutterTextDirection  : Read / Write
    +
      "text-direction"           ClutterTextDirection  : Read / Write

    Direction of the text.

    Default value: CLUTTER_TEXT_DIRECTION_LTR


    The "visible" property

    -
      "visible"                  gboolean              : Read / Write
    +
      "visible"                  gboolean              : Read / Write

    Whether the actor is set to be visible or not

    See also "mapped"

    +

    +

    Default value: FALSE


    The "width" property

    -
      "width"                    gfloat                : Read / Write
    +
      "width"                    gfloat                : Read / Write

    Width of the actor (in pixels). If written, forces the minimum and natural size request of the actor to the given width. If read, returns the allocated width if available, otherwise the width request.

    +

    +

    Allowed values: >= 0

    Default value: 0


    The "x" property

    -
      "x"                        gfloat                : Read / Write
    +
      "x"                        gfloat                : Read / Write

    X coordinate of the actor in pixels. If written, forces a fixed position for the actor. If read, returns the fixed position if any, otherwise the allocation if available, otherwise 0.

    +

    +

    Default value: 0


    The "y" property

    -
      "y"                        gfloat                : Read / Write
    +
      "y"                        gfloat                : Read / Write

    Y coordinate of the actor in pixels. If written, forces a fixed position for the actor. If read, returns the fixed position if any, otherwise the allocation if available, otherwise 0.

    +

    +

    Default value: 0

    @@ -5813,10 +6924,12 @@

    Signal Details

    The "allocation-changed" signal

    -
    void                user_function                      (ClutterActor          *actor,
    -                                                        ClutterActorBox       *box,
    -                                                        ClutterAllocationFlags flags,
    -                                                        gpointer               user_data)      : Run Last
    +
    void                user_function                      (ClutterActor          *actor,
    +                                                        ClutterActorBox       *box,
    +                                                        ClutterAllocationFlags flags,
    +                                                        gpointer               user_data)      : Run Last

    The ::allocation-changed signal is emitted when the "allocation" property changes. Usually, application @@ -5824,6 +6937,8 @@ 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.

    +

    +

    Returns :

    TRUE if the passed ClutterVertex are equal + TRUE if the passed ClutterVertex are equal
    @@ -5848,17 +6963,23 @@
    -

    Since 1.0

    +

    Since 1.0


    The "button-press-event" signal

    -
    gboolean            user_function                      (ClutterActor *actor,
    -                                                        ClutterEvent *event,
    -                                                        gpointer      user_data)      : Run Last
    +
    gboolean            user_function                      (ClutterActor *actor,
    +                                                        ClutterEvent *event,
    +                                                        gpointer      user_data)      : Run Last

    The ::button-press-event signal is emitted each time a mouse button is pressed on actor.

    +

    +

    @@ -5878,23 +6999,29 @@ -

    Returns :

    TRUE if the event has been handled by the actor, - or FALSE to continue the emission. + TRUE if the event has been handled by the actor, + or FALSE to continue the emission.
    -

    Since 0.6

    +

    Since 0.6


    The "button-release-event" signal

    -
    gboolean            user_function                      (ClutterActor *actor,
    -                                                        ClutterEvent *event,
    -                                                        gpointer      user_data)      : Run Last
    +
    gboolean            user_function                      (ClutterActor *actor,
    +                                                        ClutterEvent *event,
    +                                                        gpointer      user_data)      : Run Last

    The ::button-release-event signal is emitted each time a mouse button is released on actor.

    +

    +

    @@ -5914,21 +7041,25 @@ -

    Returns :

    TRUE if the event has been handled by the actor, - or FALSE to continue the emission. + TRUE if the event has been handled by the actor, + or FALSE to continue the emission.
    -

    Since 0.6

    +

    Since 0.6


    The "captured-event" signal

    -
    gboolean            user_function                      (ClutterActor *actor,
    -                                                        ClutterEvent *event,
    -                                                        gpointer      user_data)      : Run Last
    +
    gboolean            user_function                      (ClutterActor *actor,
    +                                                        ClutterEvent *event,
    +                                                        gpointer      user_data)      : Run Last

    The ::captured-event signal is emitted when an event is captured by Clutter. This signal will be emitted starting from the top-level @@ -5937,6 +7068,8 @@ event before the specialized events (like ClutterActor::button-press-event or ::key-released-event) are emitted.

    +

    +

    @@ -5956,24 +7089,28 @@ -

    Returns :

    TRUE if the event has been handled by the actor, - or FALSE to continue the emission. + TRUE if the event has been handled by the actor, + or FALSE to continue the emission.
    -

    Since 0.6

    +

    Since 0.6


    The "destroy" signal

    -
    void                user_function                      (ClutterActor *actor,
    -                                                        gpointer      user_data)      : Cleanup / No Recursion / No Hooks
    +
    void                user_function                      (ClutterActor *actor,
    +                                                        gpointer      user_data)      : Cleanup / No Recursion / No Hooks

    The ::destroy signal is emitted when an actor is destroyed, either by direct invocation of clutter_actor_destroy() or when the ClutterGroup that contains the actor is destroyed.

    +

    +

    @@ -5988,16 +7125,22 @@
    -

    Since 0.2

    +

    Since 0.2


    The "enter-event" signal

    -
    gboolean            user_function                      (ClutterActor *actor,
    -                                                        ClutterEvent *event,
    -                                                        gpointer      user_data)      : Run Last
    +
    gboolean            user_function                      (ClutterActor *actor,
    +                                                        ClutterEvent *event,
    +                                                        gpointer      user_data)      : Run Last

    The ::enter-event signal is emitted when the pointer enters the actor

    +

    +

    @@ -6017,26 +7160,32 @@ -

    Returns :

    TRUE if the event has been handled by the actor, - or FALSE to continue the emission. + TRUE if the event has been handled by the actor, + or FALSE to continue the emission.
    -

    Since 0.6

    +

    Since 0.6


    The "event" signal

    -
    gboolean            user_function                      (ClutterActor *actor,
    -                                                        ClutterEvent *event,
    -                                                        gpointer      user_data)      : Run Last
    +
    gboolean            user_function                      (ClutterActor *actor,
    +                                                        ClutterEvent *event,
    +                                                        gpointer      user_data)      : Run Last

    The ::event signal is emitted each time an event is received by the actor. This signal will be emitted on every actor, following the hierarchy chain, until it reaches the top-level container (the ClutterStage).

    +

    +

    @@ -6056,23 +7205,27 @@ -

    Returns :

    TRUE if the event has been handled by the actor, - or FALSE to continue the emission. + TRUE if the event has been handled by the actor, + or FALSE to continue the emission.
    -

    Since 0.6

    +

    Since 0.6


    The "hide" signal

    -
    void                user_function                      (ClutterActor *actor,
    -                                                        gpointer      user_data)      : Run First
    +
    void                user_function                      (ClutterActor *actor,
    +                                                        gpointer      user_data)      : Run First

    The ::hide signal is emitted when an actor is no longer rendered on the stage.

    +

    +

    @@ -6087,15 +7240,19 @@
    -

    Since 0.2

    +

    Since 0.2


    The "key-focus-in" signal

    -
    void                user_function                      (ClutterActor *actor,
    -                                                        gpointer      user_data)      : Run Last
    +
    void                user_function                      (ClutterActor *actor,
    +                                                        gpointer      user_data)      : Run Last

    The ::focus-in signal is emitted when actor recieves key focus.

    +

    +

    @@ -6110,15 +7267,19 @@
    -

    Since 0.6

    +

    Since 0.6


    The "key-focus-out" signal

    -
    void                user_function                      (ClutterActor *actor,
    -                                                        gpointer      user_data)      : Run Last
    +
    void                user_function                      (ClutterActor *actor,
    +                                                        gpointer      user_data)      : Run Last

    The ::key-focus-out signal is emitted when actor loses key focus.

    +

    +

    @@ -6133,17 +7294,23 @@
    -

    Since 0.6

    +

    Since 0.6


    The "key-press-event" signal

    -
    gboolean            user_function                      (ClutterActor *actor,
    -                                                        ClutterEvent *event,
    -                                                        gpointer      user_data)      : Run Last
    +
    gboolean            user_function                      (ClutterActor *actor,
    +                                                        ClutterEvent *event,
    +                                                        gpointer      user_data)      : Run Last

    The ::key-press-event signal is emitted each time a keyboard button is pressed while actor has key focus (see clutter_stage_set_key_focus()).

    +

    +

    @@ -6163,25 +7330,31 @@ -

    Returns :

    TRUE if the event has been handled by the actor, - or FALSE to continue the emission. + TRUE if the event has been handled by the actor, + or FALSE to continue the emission.
    -

    Since 0.6

    +

    Since 0.6


    The "key-release-event" signal

    -
    gboolean            user_function                      (ClutterActor *actor,
    -                                                        ClutterEvent *event,
    -                                                        gpointer      user_data)      : Run Last
    +
    gboolean            user_function                      (ClutterActor *actor,
    +                                                        ClutterEvent *event,
    +                                                        gpointer      user_data)      : Run Last

    The ::key-release-event signal is emitted each time a keyboard button is released while actor has key focus (see clutter_stage_set_key_focus()).

    +

    +

    @@ -6201,23 +7374,29 @@ -

    Returns :

    TRUE if the event has been handled by the actor, - or FALSE to continue the emission. + TRUE if the event has been handled by the actor, + or FALSE to continue the emission.
    -

    Since 0.6

    +

    Since 0.6


    The "leave-event" signal

    -
    gboolean            user_function                      (ClutterActor *actor,
    -                                                        ClutterEvent *event,
    -                                                        gpointer      user_data)      : Run Last
    +
    gboolean            user_function                      (ClutterActor *actor,
    +                                                        ClutterEvent *event,
    +                                                        gpointer      user_data)      : Run Last

    The ::leave-event signal is emitted when the pointer leaves the actor.

    +

    +

    @@ -6237,24 +7416,30 @@ -

    Returns :

    TRUE if the event has been handled by the actor, - or FALSE to continue the emission. + TRUE if the event has been handled by the actor, + or FALSE to continue the emission.
    -

    Since 0.6

    +

    Since 0.6


    The "motion-event" signal

    -
    gboolean            user_function                      (ClutterActor *actor,
    -                                                        ClutterEvent *event,
    -                                                        gpointer      user_data)      : Run Last
    +
    gboolean            user_function                      (ClutterActor *actor,
    +                                                        ClutterEvent *event,
    +                                                        gpointer      user_data)      : Run Last

    The ::motion-event signal is emitted each time the mouse pointer is moved over actor.

    +

    +

    @@ -6274,20 +7459,22 @@ -

    Returns :

    TRUE if the event has been handled by the actor, - or FALSE to continue the emission. + TRUE if the event has been handled by the actor, + or FALSE to continue the emission.
    -

    Since 0.6

    +

    Since 0.6


    The "paint" signal

    -
    void                user_function                      (ClutterActor *actor,
    -                                                        gpointer      user_data)      : Run Last
    +
    void                user_function                      (ClutterActor *actor,
    +                                                        gpointer      user_data)      : Run Last

    The ::paint signal is emitted each time an actor is being painted.

    @@ -6298,6 +7485,8 @@

    It is possible to connect a handler to the ::paint signal in order to set up some custom aspect of a paint.

    +

    +

    @@ -6312,16 +7501,20 @@
    -

    Since 0.8

    +

    Since 0.8


    The "parent-set" signal

    -
    void                user_function                      (ClutterActor *actor,
    -                                                        ClutterActor *old_parent,
    -                                                        gpointer      user_data)       : Run Last
    +
    void                user_function                      (ClutterActor *actor,
    +                                                        ClutterActor *old_parent,
    +                                                        gpointer      user_data)       : Run Last

    This signal is emitted when the parent of the actor changes.

    +

    +

    @@ -6332,7 +7525,7 @@ - @@ -6341,14 +7534,16 @@

    old_parent :

    the previous parent of the actor, or NULL + the previous parent of the actor, or NULL
    -

    Since 0.2

    +

    Since 0.2


    The "pick" signal

    -
    void                user_function                      (ClutterActor *actor,
    -                                                        ClutterColor *color,
    -                                                        gpointer      user_data)      : Run Last
    +
    void                user_function                      (ClutterActor *actor,
    +                                                        ClutterColor *color,
    +                                                        gpointer      user_data)      : Run Last

    The ::pick signal is emitted each time an actor is being painted in "pick mode". The pick mode is used to identify the actor during @@ -6362,6 +7557,8 @@

    It is possible to connect a handler to the ::pick signal in order to set up some custom aspect of a paint in pick mode.

    +

    +

    @@ -6381,14 +7578,16 @@
    -

    Since 1.0

    +

    Since 1.0


    The "queue-redraw" signal

    -
    void                user_function                      (ClutterActor *actor,
    -                                                        ClutterActor *origin,
    -                                                        gpointer      user_data)      : Run Last
    +
    void                user_function                      (ClutterActor *actor,
    +                                                        ClutterActor *origin,
    +                                                        gpointer      user_data)      : Run Last

    The ::queue_redraw signal is emitted when clutter_actor_queue_redraw() is called on origin. @@ -6441,8 +7640,12 @@

    This signal is emitted before the Clutter paint pipeline is executed. If you want to know when the pipeline has been completed you should connect to the ::paint signal on the -Stage with g_signal_connect_after().

    +Stage with g_signal_connect_after().

    +

    +

    @@ -6462,13 +7665,15 @@
    -

    Since 1.0

    +

    Since 1.0


    The "queue-relayout" signal

    -
    void                user_function                      (ClutterActor *actor,
    -                                                        gpointer      user_data)      : Run Last
    +
    void                user_function                      (ClutterActor *actor,
    +                                                        gpointer      user_data)      : Run Last

    The ::queue_layout signal is emitted when clutter_actor_queue_relayout() is called on an actor. @@ -6482,6 +7687,8 @@ The main purpose of this signal is to allow relayout to be propagated properly in the procense of ClutterClone actors. Applications will not normally need to connect to this signal.

    +

    +

    @@ -6496,16 +7703,20 @@
    -

    Since 1.2

    +

    Since 1.2


    The "realize" signal

    -
    void                user_function                      (ClutterActor *actor,
    -                                                        gpointer      user_data)      : Run Last
    +
    void                user_function                      (ClutterActor *actor,
    +                                                        gpointer      user_data)      : Run Last

    The ::realize signal is emitted each time an actor is being realized.

    +

    +

    @@ -6520,17 +7731,23 @@
    -

    Since 0.8

    +

    Since 0.8


    The "scroll-event" signal

    -
    gboolean            user_function                      (ClutterActor *actor,
    -                                                        ClutterEvent *event,
    -                                                        gpointer      user_data)      : Run Last
    +
    gboolean            user_function                      (ClutterActor *actor,
    +                                                        ClutterEvent *event,
    +                                                        gpointer      user_data)      : Run Last

    The ::scroll-event signal is emitted each time the mouse is scrolled on actor

    +

    +

    @@ -6550,23 +7767,27 @@ -

    Returns :

    TRUE if the event has been handled by the actor, - or FALSE to continue the emission. + TRUE if the event has been handled by the actor, + or FALSE to continue the emission.
    -

    Since 0.6

    +

    Since 0.6


    The "show" signal

    -
    void                user_function                      (ClutterActor *actor,
    -                                                        gpointer      user_data)      : Run First
    +
    void                user_function                      (ClutterActor *actor,
    +                                                        gpointer      user_data)      : Run First

    The ::show signal is emitted when an actor is visible and rendered on the stage.

    +

    +

    @@ -6581,16 +7802,20 @@
    -

    Since 0.2

    +

    Since 0.2


    The "unrealize" signal

    -
    void                user_function                      (ClutterActor *actor,
    -                                                        gpointer      user_data)      : Run Last
    +
    void                user_function                      (ClutterActor *actor,
    +                                                        gpointer      user_data)      : Run Last

    The ::unrealize signal is emitted each time an actor is being unrealized.

    +

    +

    @@ -6605,12 +7830,12 @@
    -

    Since 0.8

    +

    Since 0.8

    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/clutter-ClutterBackend.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/clutter-ClutterBackend.html @@ -8,7 +8,7 @@ - + @@ -62,8 +62,8 @@
    Top -  |  - Description +  |  + Description
    @@ -77,27 +77,48 @@

    Synopsis

    -
    ClutterBackend *    clutter_get_default_backend         (void);
    -void                clutter_backend_set_resolution      (ClutterBackend *backend,
    -                                                         gdouble dpi);
    -gdouble             clutter_backend_get_resolution      (ClutterBackend *backend);
    -void                clutter_backend_set_double_click_time
    -                                                        (ClutterBackend *backend,
    -                                                         guint msec);
    -guint               clutter_backend_get_double_click_time
    -                                                        (ClutterBackend *backend);
    -void                clutter_backend_set_double_click_distance
    -                                                        (ClutterBackend *backend,
    -                                                         guint distance);
    -guint               clutter_backend_get_double_click_distance
    -                                                        (ClutterBackend *backend);
    -void                clutter_backend_set_font_options    (ClutterBackend *backend,
    -                                                         const cairo_font_options_t *options);
    -const cairo_font_options_t * clutter_backend_get_font_options
    -                                                        (ClutterBackend *backend);
    -void                clutter_backend_set_font_name       (ClutterBackend *backend,
    -                                                         const gchar *font_name);
    -const gchar *       clutter_backend_get_font_name       (ClutterBackend *backend);
    +
    +ClutterBackend *    clutter_get_default_backend         (void);
    +void                clutter_backend_set_resolution      (ClutterBackend *backend,
    +                                                         gdouble dpi);
    +gdouble             clutter_backend_get_resolution      (ClutterBackend *backend);
    +void                clutter_backend_set_double_click_time
    +                                                        (ClutterBackend *backend,
    +                                                         guint msec);
    +guint               clutter_backend_get_double_click_time
    +                                                        (ClutterBackend *backend);
    +void                clutter_backend_set_double_click_distance
    +                                                        (ClutterBackend *backend,
    +                                                         guint distance);
    +guint               clutter_backend_get_double_click_distance
    +                                                        (ClutterBackend *backend);
    +void                clutter_backend_set_font_options    (ClutterBackend *backend,
    +                                                         const cairo_font_options_t *options);
    +const cairo_font_options_t * clutter_backend_get_font_options
    +                                                        (ClutterBackend *backend);
    +void                clutter_backend_set_font_name       (ClutterBackend *backend,
    +                                                         const gchar *font_name);
    +const gchar *       clutter_backend_get_font_name       (ClutterBackend *backend);
     
    @@ -113,20 +134,24 @@

    ClutterBackend is available since Clutter 0.4

    +

    +

    Details

    clutter_get_default_backend ()

    -
    ClutterBackend *    clutter_get_default_backend         (void);
    +
    ClutterBackend *    clutter_get_default_backend         (void);

    Retrieves the default ClutterBackend used by Clutter. The ClutterBackend holds backend-specific configuration options.

    +

    +

    - +

    Returns :

    transfer none. transfer none. transfer none. transfer none.

    Since 0.4

    @@ -134,16 +159,22 @@

    clutter_backend_set_resolution ()

    -
    void                clutter_backend_set_resolution      (ClutterBackend *backend,
    -                                                         gdouble dpi);
    +
    void                clutter_backend_set_resolution      (ClutterBackend *backend,
    +                                                         gdouble dpi);

    Sets the resolution for font handling on the screen. This is a -scale factor between points specified in a PangoFontDescription +scale factor between points specified in a PangoFontDescription and cairo units. The default value is 96, meaning that a 10 point font will be 13 units high. (10 * 96. / 72. = 13.3).

    Applications should never need to call this function.

    +

    +

    @@ -165,10 +196,14 @@

    clutter_backend_get_resolution ()

    -
    gdouble             clutter_backend_get_resolution      (ClutterBackend *backend);
    +
    gdouble             clutter_backend_get_resolution      (ClutterBackend *backend);

    Gets the resolution for font handling on the screen; see clutter_backend_set_resolution() for full details.

    +

    +

    @@ -191,12 +226,16 @@

    clutter_backend_set_double_click_time ()

    -
    void                clutter_backend_set_double_click_time
    -                                                        (ClutterBackend *backend,
    -                                                         guint msec);
    +
    void                clutter_backend_set_double_click_time
    +                                                        (ClutterBackend *backend,
    +                                                         guint msec);

    Sets the maximum time between two button press events, used to verify whether it's a double click event or not.

    +

    +

    @@ -217,11 +256,15 @@

    clutter_backend_get_double_click_time ()

    -
    guint               clutter_backend_get_double_click_time
    -                                                        (ClutterBackend *backend);
    +
    guint               clutter_backend_get_double_click_time
    +                                                        (ClutterBackend *backend);

    Gets the maximum time between two button press events, as set by clutter_backend_set_double_click_time().

    +

    +

    @@ -243,11 +286,15 @@

    clutter_backend_set_double_click_distance ()

    -
    void                clutter_backend_set_double_click_distance
    -                                                        (ClutterBackend *backend,
    -                                                         guint distance);
    +
    void                clutter_backend_set_double_click_distance
    +                                                        (ClutterBackend *backend,
    +                                                         guint distance);

    Sets the maximum distance used to verify a double click event.

    +

    +

    @@ -268,10 +315,14 @@

    clutter_backend_get_double_click_distance ()

    -
    guint               clutter_backend_get_double_click_distance
    -                                                        (ClutterBackend *backend);
    +
    guint               clutter_backend_get_double_click_distance
    +                                                        (ClutterBackend *backend);

    Retrieves the distance used to verify a double click event

    +

    +

    @@ -293,20 +344,26 @@

    clutter_backend_set_font_options ()

    -
    void                clutter_backend_set_font_options    (ClutterBackend *backend,
    -                                                         const cairo_font_options_t *options);
    +
    void                clutter_backend_set_font_options    (ClutterBackend *backend,
    +                                                         const cairo_font_options_t *options);

    Sets the new font options for backend. The ClutterBackend will -copy the cairo_font_options_t. +copy the cairo_font_options_t.

    -If options is NULL, the first following call to +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.

    +

    +

    @@ -317,7 +374,7 @@ - @@ -327,10 +384,14 @@

    clutter_backend_get_font_options ()

    -
    const cairo_font_options_t * clutter_backend_get_font_options
    -                                                        (ClutterBackend *backend);
    +
    const cairo_font_options_t * clutter_backend_get_font_options
    +                                                        (ClutterBackend *backend);

    Retrieves the font options for backend.

    +

    +

    options :

    Cairo font options for the backend, or NULL + Cairo font options for the backend, or NULL
    @@ -341,7 +402,7 @@ - +

    Returns :

    transfer none. transfer none. transfer none. transfer none.
    @@ -350,13 +411,19 @@

    clutter_backend_set_font_name ()

    -
    void                clutter_backend_set_font_name       (ClutterBackend *backend,
    -                                                         const gchar *font_name);
    +
    void                clutter_backend_set_font_name       (ClutterBackend *backend,
    +                                                         const gchar *font_name);

    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 +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.

    +be parsed by the pango_font_description_from_string() function.

    +

    +

    @@ -377,10 +444,14 @@

    clutter_backend_get_font_name ()

    -
    const gchar *       clutter_backend_get_font_name       (ClutterBackend *backend);
    +
    const gchar *       clutter_backend_get_font_name       (ClutterBackend *backend);

    Retrieves the default font name as set by clutter_backend_set_font_name().

    +

    +

    @@ -404,6 +475,6 @@ + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ix01.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ix01.html @@ -8,7 +8,7 @@ - + @@ -52,61 +52,21 @@ -
    - + - - - +

    -Index of all symbols

    -

    A

    -
    ClutterActor
    +Index of all symbols
    +
    + + + + +
    +

    E

    +
    clutter_eglx_display
    clutter_egl_display
    @@ -1258,22 +1234,26 @@
    clutter_event_type
    -

    F

    +
    +
    + + + + + + +
    +

    N

    +
    +
    CLUTTER_NO_FPU
    -

    P

    +
    +
    + + + + + + + + +
    +
    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/migration.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/migration.html @@ -8,7 +8,7 @@ - + @@ -81,6 +81,6 @@
    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ClutterText.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ClutterText.html @@ -8,7 +8,7 @@ - + @@ -62,16 +62,16 @@ Top -  |  - Description -  |  - Object Hierarchy -  |  - Implemented Interfaces -  |  - Properties -  |  - Signals +  |  + Description +  |  + Object Hierarchy +  |  + Implemented Interfaces +  |  + Properties +  |  + Signals
    @@ -85,128 +85,269 @@

    Synopsis

    -
                        ClutterText;
    +
    +                    ClutterText;
                         ClutterTextClass;
    -ClutterActor *      clutter_text_new                    (void);
    -ClutterActor *      clutter_text_new_full               (const gchar *font_name,
    -                                                         const gchar *text,
    -                                                         const ClutterColor *color);
    -ClutterActor *      clutter_text_new_with_text          (const gchar *font_name,
    -                                                         const gchar *text);
    -
    -void                clutter_text_set_text               (ClutterText *self,
    -                                                         const gchar *text);
    -void                clutter_text_set_markup             (ClutterText *self,
    -                                                         const gchar *markup);
    -const gchar *       clutter_text_get_text               (ClutterText *self);
    -void                clutter_text_set_activatable        (ClutterText *self,
    -                                                         gboolean activatable);
    -gboolean            clutter_text_get_activatable        (ClutterText *self);
    -void                clutter_text_set_attributes         (ClutterText *self,
    -                                                         PangoAttrList *attrs);
    -PangoAttrList *     clutter_text_get_attributes         (ClutterText *self);
    -void                clutter_text_set_color              (ClutterText *self,
    -                                                         const ClutterColor *color);
    -void                clutter_text_get_color              (ClutterText *self,
    -                                                         ClutterColor *color);
    -void                clutter_text_set_ellipsize          (ClutterText *self,
    -                                                         PangoEllipsizeMode mode);
    -PangoEllipsizeMode  clutter_text_get_ellipsize          (ClutterText *self);
    -void                clutter_text_set_font_name          (ClutterText *self,
    -                                                         const gchar *font_name);
    -const gchar *       clutter_text_get_font_name          (ClutterText *self);
    -void                clutter_text_set_font_description   (ClutterText *self,
    -                                                         PangoFontDescription *font_desc);
    -PangoFontDescription * clutter_text_get_font_description
    -                                                        (ClutterText *self);
    -void                clutter_text_set_password_char      (ClutterText *self,
    -                                                         gunichar wc);
    -gunichar            clutter_text_get_password_char      (ClutterText *self);
    -void                clutter_text_set_justify            (ClutterText *self,
    -                                                         gboolean justify);
    -gboolean            clutter_text_get_justify            (ClutterText *self);
    -PangoLayout *       clutter_text_get_layout             (ClutterText *self);
    -void                clutter_text_set_line_alignment     (ClutterText *self,
    -                                                         PangoAlignment alignment);
    -PangoAlignment      clutter_text_get_line_alignment     (ClutterText *self);
    -void                clutter_text_set_line_wrap          (ClutterText *self,
    -                                                         gboolean line_wrap);
    -gboolean            clutter_text_get_line_wrap          (ClutterText *self);
    -void                clutter_text_set_line_wrap_mode     (ClutterText *self,
    -                                                         PangoWrapMode wrap_mode);
    -PangoWrapMode       clutter_text_get_line_wrap_mode     (ClutterText *self);
    -void                clutter_text_set_max_length         (ClutterText *self,
    -                                                         gint max);
    -gint                clutter_text_get_max_length         (ClutterText *self);
    -void                clutter_text_set_selectable         (ClutterText *self,
    -                                                         gboolean selectable);
    -gboolean            clutter_text_get_selectable         (ClutterText *self);
    -void                clutter_text_set_selection          (ClutterText *self,
    -                                                         gssize start_pos,
    -                                                         gssize end_pos);
    -gchar *             clutter_text_get_selection          (ClutterText *self);
    -void                clutter_text_set_selection_bound    (ClutterText *self,
    -                                                         gint selection_bound);
    -gint                clutter_text_get_selection_bound    (ClutterText *self);
    -void                clutter_text_set_single_line_mode   (ClutterText *self,
    -                                                         gboolean single_line);
    -gboolean            clutter_text_get_single_line_mode   (ClutterText *self);
    -void                clutter_text_set_use_markup         (ClutterText *self,
    -                                                         gboolean setting);
    -gboolean            clutter_text_get_use_markup         (ClutterText *self);
    -
    -void                clutter_text_set_editable           (ClutterText *self,
    -                                                         gboolean editable);
    -gboolean            clutter_text_get_editable           (ClutterText *self);
    -void                clutter_text_insert_text            (ClutterText *self,
    -                                                         const gchar *text,
    -                                                         gssize position);
    -void                clutter_text_insert_unichar         (ClutterText *self,
    -                                                         gunichar wc);
    -void                clutter_text_delete_chars           (ClutterText *self,
    -                                                         guint n_chars);
    -void                clutter_text_delete_text            (ClutterText *self,
    -                                                         gssize start_pos,
    -                                                         gssize end_pos);
    -gboolean            clutter_text_delete_selection       (ClutterText *self);
    -gchar *             clutter_text_get_chars              (ClutterText *self,
    -                                                         gssize start_pos,
    -                                                         gssize end_pos);
    -void                clutter_text_set_cursor_color       (ClutterText *self,
    -                                                         const ClutterColor *color);
    -void                clutter_text_get_cursor_color       (ClutterText *self,
    -                                                         ClutterColor *color);
    -void                clutter_text_set_selection_color    (ClutterText *self,
    -                                                         const ClutterColor *color);
    -void                clutter_text_get_selection_color    (ClutterText *self,
    -                                                         ClutterColor *color);
    -void                clutter_text_set_cursor_position    (ClutterText *self,
    -                                                         gint position);
    -gint                clutter_text_get_cursor_position    (ClutterText *self);
    -void                clutter_text_set_cursor_visible     (ClutterText *self,
    -                                                         gboolean cursor_visible);
    -gboolean            clutter_text_get_cursor_visible     (ClutterText *self);
    -void                clutter_text_set_cursor_size        (ClutterText *self,
    -                                                         gint size);
    -guint               clutter_text_get_cursor_size        (ClutterText *self);
    -
    -gboolean            clutter_text_activate               (ClutterText *self);
    -gboolean            clutter_text_position_to_coords     (ClutterText *self,
    -                                                         gint position,
    -                                                         gfloat *x,
    -                                                         gfloat *y,
    -                                                         gfloat *line_height);
    -void                clutter_text_set_preedit_string     (ClutterText *self,
    -                                                         const gchar *preedit_str,
    -                                                         PangoAttrList *preedit_attrs,
    -                                                         guint cursor_pos);
    +ClutterActor *      clutter_text_new                    (void);
    +ClutterActor *      clutter_text_new_full               (const gchar *font_name,
    +                                                         const gchar *text,
    +                                                         const ClutterColor *color);
    +ClutterActor *      clutter_text_new_with_text          (const gchar *font_name,
    +                                                         const gchar *text);
    +
    +void                clutter_text_set_text               (ClutterText *self,
    +                                                         const gchar *text);
    +void                clutter_text_set_markup             (ClutterText *self,
    +                                                         const gchar *markup);
    +const gchar *       clutter_text_get_text               (ClutterText *self);
    +void                clutter_text_set_activatable        (ClutterText *self,
    +                                                         gboolean activatable);
    +gboolean            clutter_text_get_activatable        (ClutterText *self);
    +void                clutter_text_set_attributes         (ClutterText *self,
    +                                                         PangoAttrList *attrs);
    +PangoAttrList *     clutter_text_get_attributes         (ClutterText *self);
    +void                clutter_text_set_color              (ClutterText *self,
    +                                                         const ClutterColor *color);
    +void                clutter_text_get_color              (ClutterText *self,
    +                                                         ClutterColor *color);
    +void                clutter_text_set_ellipsize          (ClutterText *self,
    +                                                         PangoEllipsizeMode mode);
    +PangoEllipsizeMode  clutter_text_get_ellipsize          (ClutterText *self);
    +void                clutter_text_set_font_name          (ClutterText *self,
    +                                                         const gchar *font_name);
    +const gchar *       clutter_text_get_font_name          (ClutterText *self);
    +void                clutter_text_set_font_description   (ClutterText *self,
    +                                                         PangoFontDescription *font_desc);
    +PangoFontDescription * clutter_text_get_font_description
    +                                                        (ClutterText *self);
    +void                clutter_text_set_password_char      (ClutterText *self,
    +                                                         gunichar wc);
    +gunichar            clutter_text_get_password_char      (ClutterText *self);
    +void                clutter_text_set_justify            (ClutterText *self,
    +                                                         gboolean justify);
    +gboolean            clutter_text_get_justify            (ClutterText *self);
    +PangoLayout *       clutter_text_get_layout             (ClutterText *self);
    +void                clutter_text_set_line_alignment     (ClutterText *self,
    +                                                         PangoAlignment alignment);
    +PangoAlignment      clutter_text_get_line_alignment     (ClutterText *self);
    +void                clutter_text_set_line_wrap          (ClutterText *self,
    +                                                         gboolean line_wrap);
    +gboolean            clutter_text_get_line_wrap          (ClutterText *self);
    +void                clutter_text_set_line_wrap_mode     (ClutterText *self,
    +                                                         PangoWrapMode wrap_mode);
    +PangoWrapMode       clutter_text_get_line_wrap_mode     (ClutterText *self);
    +void                clutter_text_set_max_length         (ClutterText *self,
    +                                                         gint max);
    +gint                clutter_text_get_max_length         (ClutterText *self);
    +void                clutter_text_set_selectable         (ClutterText *self,
    +                                                         gboolean selectable);
    +gboolean            clutter_text_get_selectable         (ClutterText *self);
    +void                clutter_text_set_selection          (ClutterText *self,
    +                                                         gssize start_pos,
    +                                                         gssize end_pos);
    +gchar *             clutter_text_get_selection          (ClutterText *self);
    +void                clutter_text_set_selection_bound    (ClutterText *self,
    +                                                         gint selection_bound);
    +gint                clutter_text_get_selection_bound    (ClutterText *self);
    +void                clutter_text_set_single_line_mode   (ClutterText *self,
    +                                                         gboolean single_line);
    +gboolean            clutter_text_get_single_line_mode   (ClutterText *self);
    +void                clutter_text_set_use_markup         (ClutterText *self,
    +                                                         gboolean setting);
    +gboolean            clutter_text_get_use_markup         (ClutterText *self);
    +
    +void                clutter_text_set_editable           (ClutterText *self,
    +                                                         gboolean editable);
    +gboolean            clutter_text_get_editable           (ClutterText *self);
    +void                clutter_text_insert_text            (ClutterText *self,
    +                                                         const gchar *text,
    +                                                         gssize position);
    +void                clutter_text_insert_unichar         (ClutterText *self,
    +                                                         gunichar wc);
    +void                clutter_text_delete_chars           (ClutterText *self,
    +                                                         guint n_chars);
    +void                clutter_text_delete_text            (ClutterText *self,
    +                                                         gssize start_pos,
    +                                                         gssize end_pos);
    +gboolean            clutter_text_delete_selection       (ClutterText *self);
    +gchar *             clutter_text_get_chars              (ClutterText *self,
    +                                                         gssize start_pos,
    +                                                         gssize end_pos);
    +void                clutter_text_set_cursor_color       (ClutterText *self,
    +                                                         const ClutterColor *color);
    +void                clutter_text_get_cursor_color       (ClutterText *self,
    +                                                         ClutterColor *color);
    +void                clutter_text_set_selection_color    (ClutterText *self,
    +                                                         const ClutterColor *color);
    +void                clutter_text_get_selection_color    (ClutterText *self,
    +                                                         ClutterColor *color);
    +void                clutter_text_set_cursor_position    (ClutterText *self,
    +                                                         gint position);
    +gint                clutter_text_get_cursor_position    (ClutterText *self);
    +void                clutter_text_set_cursor_visible     (ClutterText *self,
    +                                                         gboolean cursor_visible);
    +gboolean            clutter_text_get_cursor_visible     (ClutterText *self);
    +void                clutter_text_set_cursor_size        (ClutterText *self,
    +                                                         gint size);
    +guint               clutter_text_get_cursor_size        (ClutterText *self);
    +
    +gboolean            clutter_text_activate               (ClutterText *self);
    +gboolean            clutter_text_position_to_coords     (ClutterText *self,
    +                                                         gint position,
    +                                                         gfloat *x,
    +                                                         gfloat *y,
    +                                                         gfloat *line_height);
    +void                clutter_text_set_preedit_string     (ClutterText *self,
    +                                                         const gchar *preedit_str,
    +                                                         PangoAttrList *preedit_attrs,
    +                                                         guint cursor_pos);
     

    Object Hierarchy

    -  GObject
    -   +----GInitiallyUnowned
    +  GObject
    +   +----GInitiallyUnowned
              +----ClutterActor
                    +----ClutterText
     
    @@ -220,31 +361,75 @@

    Properties

    -  "activatable"              gboolean              : Read / Write
    -  "attributes"               PangoAttrList*        : Read / Write
    -  "color"                    ClutterColor*         : Read / Write
    -  "cursor-color"             ClutterColor*         : Read / Write
    -  "cursor-color-set"         gboolean              : Read
    -  "cursor-size"              gint                  : Read / Write
    -  "cursor-visible"           gboolean              : Read / Write
    -  "editable"                 gboolean              : Read / Write
    -  "ellipsize"                PangoEllipsizeMode    : Read / Write
    -  "font-description"         PangoFontDescription*  : Read / Write
    -  "font-name"                gchar*                : Read / Write
    -  "justify"                  gboolean              : Read / Write
    -  "line-alignment"           PangoAlignment        : Read / Write
    -  "line-wrap"                gboolean              : Read / Write
    -  "line-wrap-mode"           PangoWrapMode         : Read / Write
    -  "max-length"               gint                  : Read / Write
    -  "password-char"            guint                 : Read / Write
    -  "position"                 gint                  : Read / Write
    -  "selectable"               gboolean              : Read / Write
    -  "selection-bound"          gint                  : Read / Write
    -  "selection-color"          ClutterColor*         : Read / Write
    -  "selection-color-set"      gboolean              : Read
    -  "single-line-mode"         gboolean              : Read / Write
    -  "text"                     gchar*                : Read / Write
    -  "use-markup"               gboolean              : Read / Write
    +  "activatable"              gboolean              : Read / Write
    +  "attributes"               PangoAttrList*        : Read / Write
    +  "color"                    ClutterColor*         : Read / Write
    +  "cursor-color"             ClutterColor*         : Read / Write
    +  "cursor-color-set"         gboolean              : Read
    +  "cursor-size"              gint                  : Read / Write
    +  "cursor-visible"           gboolean              : Read / Write
    +  "editable"                 gboolean              : Read / Write
    +  "ellipsize"                PangoEllipsizeMode    : Read / Write
    +  "font-description"         PangoFontDescription*  : Read / Write
    +  "font-name"                gchar*                : Read / Write
    +  "justify"                  gboolean              : Read / Write
    +  "line-alignment"           PangoAlignment        : Read / Write
    +  "line-wrap"                gboolean              : Read / Write
    +  "line-wrap-mode"           PangoWrapMode         : Read / Write
    +  "max-length"               gint                  : Read / Write
    +  "password-char"            guint                 : Read / Write
    +  "position"                 gint                  : Read / Write
    +  "selectable"               gboolean              : Read / Write
    +  "selection-bound"          gint                  : Read / Write
    +  "selection-color"          ClutterColor*         : Read / Write
    +  "selection-color-set"      gboolean              : Read
    +  "single-line-mode"         gboolean              : Read / Write
    +  "text"                     gchar*                : Read / Write
    +  "use-markup"               gboolean              : Read / Write
     
    @@ -273,6 +458,8 @@

    ClutterText is available since Clutter 1.0

    +

    +

    Details

    @@ -281,6 +468,8 @@
    typedef struct _ClutterText ClutterText;

    The ClutterText struct contains only private data.

    +

    +

    Since 1.0


    @@ -296,21 +485,23 @@

    The ClutterTextClass struct contains only private data.

    +

    +

    - + - + - + @@ -321,10 +512,12 @@

    clutter_text_new ()

    -
    ClutterActor *      clutter_text_new                    (void);
    +
    ClutterActor *      clutter_text_new                    (void);

    Creates a new ClutterText actor. This actor can be used to display and edit text.

    +

    +

    text_changed ()

    text_changed ()

    class handler for the "text-changed" signal

    activate ()

    activate ()

    class handler for the "activate" signal

    cursor_event ()

    cursor_event ()

    class handler for the "cursor_event" signal
    @@ -339,9 +532,13 @@

    clutter_text_new_full ()

    -
    ClutterActor *      clutter_text_new_full               (const gchar *font_name,
    -                                                         const gchar *text,
    -                                                         const ClutterColor *color);
    +
    ClutterActor *      clutter_text_new_full               (const gchar *font_name,
    +                                                         const gchar *text,
    +                                                         const ClutterColor *color);

    Creates a new ClutterText actor, using font_name as the font description; text will be used to set the contents of the actor; @@ -351,6 +548,8 @@ This function is equivalent to calling clutter_text_new(), clutter_text_set_font_name(), clutter_text_set_text() and clutter_text_set_color().

    +

    +

    @@ -382,8 +581,12 @@

    clutter_text_new_with_text ()

    -
    ClutterActor *      clutter_text_new_with_text          (const gchar *font_name,
    -                                                         const gchar *text);
    +
    ClutterActor *      clutter_text_new_with_text          (const gchar *font_name,
    +                                                         const gchar *text);

    Creates a new ClutterText actor, using font_name as the font description; text will be used to set the contents of the actor. @@ -391,6 +594,8 @@

    This function is equivalent to calling clutter_text_new(), clutter_text_set_font_name(), and clutter_text_set_text().

    +

    +

    @@ -417,16 +622,20 @@

    clutter_text_set_text ()

    -
    void                clutter_text_set_text               (ClutterText *self,
    -                                                         const gchar *text);
    +
    void                clutter_text_set_text               (ClutterText *self,
    +                                                         const gchar *text);

    Sets the contents of a ClutterText actor.

    -If the "use-markup" property was set to TRUE it -will be reset to FALSE as a side effect. If you want to +If the "use-markup" property was set to TRUE it +will be reset to FALSE as a side effect. If you want to maintain the "use-markup" you should use the clutter_text_set_markup() function instead

    +

    +

    @@ -437,7 +646,7 @@ - @@ -448,8 +657,10 @@

    clutter_text_set_markup ()

    -
    void                clutter_text_set_markup             (ClutterText *self,
    -                                                         const gchar *markup);
    +
    void                clutter_text_set_markup             (ClutterText *self,
    +                                                         const gchar *markup);

    Sets markup as the contents of a ClutterText.

    @@ -463,6 +674,8 @@ clutter_text_set_text (CLUTTER_TEXT (actor), markup); clutter_text_set_use_markup (CLUTTER_TEXT (actor), TRUE);
    +

    +

    text :

    the text to set. Passing NULL is the same as passing "" (the + the text to set. Passing NULL is the same as passing "" (the empty string)
    @@ -473,7 +686,7 @@ - @@ -484,14 +697,18 @@

    clutter_text_get_text ()

    -
    const gchar *       clutter_text_get_text               (ClutterText *self);
    +
    const gchar *       clutter_text_get_text               (ClutterText *self);

    Retrieves a pointer to the current contents of a ClutterText actor.

    If you need a copy of the contents for manipulating, either -use g_strdup() on the returned string, or use: +use g_strdup() on the returned string, or use:

    @@ -502,6 +719,8 @@

    Which will return a newly allocated string.

    +

    +

    markup :

    a string containing Pango markup. Passing NULL is the same + a string containing Pango markup. Passing NULL is the same as passing "" (the empty string)
    @@ -525,8 +744,10 @@

    clutter_text_set_activatable ()

    -
    void                clutter_text_set_activatable        (ClutterText *self,
    -                                                         gboolean activatable);
    +
    void                clutter_text_set_activatable        (ClutterText *self,
    +                                                         gboolean activatable);

    Sets whether a ClutterText actor should be activatable.

    @@ -538,6 +759,8 @@

    An activatable ClutterText must also be set as editable using clutter_text_set_editable().

    +

    +

    @@ -558,9 +781,13 @@

    clutter_text_get_activatable ()

    -
    gboolean            clutter_text_get_activatable        (ClutterText *self);
    +
    gboolean            clutter_text_get_activatable        (ClutterText *self);

    Retrieves whether a ClutterText is activatable or not.

    +

    +

    @@ -571,7 +798,7 @@ - @@ -582,15 +809,21 @@

    clutter_text_set_attributes ()

    -
    void                clutter_text_set_attributes         (ClutterText *self,
    -                                                         PangoAttrList *attrs);
    +
    void                clutter_text_set_attributes         (ClutterText *self,
    +                                                         PangoAttrList *attrs);

    Sets the attributes list that are going to be applied to the ClutterText contents.

    -The ClutterText actor will take a reference on the PangoAttrList +The ClutterText actor will take a reference on the PangoAttrList passed to this function.

    +

    +

    Returns :

    TRUE if the actor is activatable + TRUE if the actor is activatable
    @@ -601,7 +834,9 @@ - @@ -611,10 +846,14 @@

    clutter_text_get_attributes ()

    -
    PangoAttrList *     clutter_text_get_attributes         (ClutterText *self);
    +
    PangoAttrList *     clutter_text_get_attributes         (ClutterText *self);

    Gets the attribute list that was set on the ClutterText actor clutter_text_set_attributes(), if any.

    +

    +

    attrs :

    a PangoAttrList or NULL to unset the attributes + a PangoAttrList or NULL to unset the attributes
    @@ -625,7 +864,7 @@ - +

    Returns :

    transfer none. transfer none. transfer none. transfer none.
    @@ -634,8 +873,8 @@

    clutter_text_set_color ()

    -
    void                clutter_text_set_color              (ClutterText *self,
    -                                                         const ClutterColor *color);
    +
    void                clutter_text_set_color              (ClutterText *self,
    +                                                         const ClutterColor *color);

    Sets the color of the contents of a ClutterText actor.

    @@ -644,6 +883,8 @@ 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().

    +

    +

    @@ -664,10 +905,12 @@

    clutter_text_get_color ()

    -
    void                clutter_text_get_color              (ClutterText *self,
    -                                                         ClutterColor *color);
    +
    void                clutter_text_get_color              (ClutterText *self,
    +                                                         ClutterColor *color);

    Retrieves the text color as set by clutter_text_set_color().

    +

    +

    @@ -688,12 +931,16 @@

    clutter_text_set_ellipsize ()

    -
    void                clutter_text_set_ellipsize          (ClutterText *self,
    -                                                         PangoEllipsizeMode mode);
    +
    void                clutter_text_set_ellipsize          (ClutterText *self,
    +                                                         PangoEllipsizeMode mode);

    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

    +

    +

    @@ -704,7 +951,9 @@ - @@ -714,10 +963,14 @@

    clutter_text_get_ellipsize ()

    -
    PangoEllipsizeMode  clutter_text_get_ellipsize          (ClutterText *self);
    +
    PangoEllipsizeMode  clutter_text_get_ellipsize          (ClutterText *self);

    Returns the ellipsizing position of a ClutterText actor, as set by clutter_text_set_ellipsize().

    +

    +

    mode :

    a PangoEllipsizeMode + a PangoEllipsizeMode
    @@ -728,7 +981,9 @@ - @@ -739,13 +994,17 @@

    clutter_text_set_font_name ()

    -
    void                clutter_text_set_font_name          (ClutterText *self,
    -                                                         const gchar *font_name);
    +
    void                clutter_text_set_font_name          (ClutterText *self,
    +                                                         const gchar *font_name);

    Sets the font used by a ClutterText. The font_name string -must either be NULL, which means that the font name from the +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, +be parsed by the pango_font_description_from_string() function, like:

    @@ -755,6 +1014,8 @@ clutter_text_set_font_name (text, "Serif 16px"); clutter_text_set_font_name (text, "Helvetica 10");

    +

    +

    Returns :

    PangoEllipsizeMode + PangoEllipsizeMode
    @@ -765,7 +1026,7 @@ - @@ -775,9 +1036,13 @@

    clutter_text_get_font_name ()

    -
    const gchar *       clutter_text_get_font_name          (ClutterText *self);
    +
    const gchar *       clutter_text_get_font_name          (ClutterText *self);

    Retrieves the font name as set by clutter_text_set_font_name().

    +

    +

    font_name :

    a font name, or NULL to set the default font name + a font name, or NULL to set the default font name
    @@ -801,15 +1066,23 @@

    clutter_text_set_font_description ()

    -
    void                clutter_text_set_font_description   (ClutterText *self,
    -                                                         PangoFontDescription *font_desc);
    +
    void                clutter_text_set_font_description   (ClutterText *self,
    +                                                         PangoFontDescription *font_desc);

    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 +The PangoFontDescription is copied by the ClutterText actor +so you can safely call pango_font_description_free() on it after calling this function.

    +

    +

    @@ -820,7 +1093,9 @@ - @@ -830,10 +1105,16 @@

    clutter_text_get_font_description ()

    -
    PangoFontDescription * clutter_text_get_font_description
    -                                                        (ClutterText *self);
    +
    PangoFontDescription * clutter_text_get_font_description
    +                                                        (ClutterText *self);
    +

    +Retrieves the PangoFontDescription used by self

    -Retrieves the PangoFontDescription used by self

    +

    font_desc :

    a PangoFontDescription + a PangoFontDescription
    @@ -844,7 +1125,9 @@ - @@ -856,8 +1139,10 @@

    clutter_text_set_password_char ()

    -
    void                clutter_text_set_password_char      (ClutterText *self,
    -                                                         gunichar wc);
    +
    void                clutter_text_set_password_char      (ClutterText *self,
    +                                                         gunichar wc);

    Sets the character to use in place of the actual text in a password text actor. @@ -865,6 +1150,8 @@

    If wc is 0 the text will be displayed as it is entered in the ClutterText actor.

    +

    +

    Returns :

    a PangoFontDescription. The returned value is owned + a PangoFontDescription. The returned value is owned by the ClutterText actor and it should not be modified or freed
    @@ -885,10 +1172,14 @@

    clutter_text_get_password_char ()

    -
    gunichar            clutter_text_get_password_char      (ClutterText *self);
    +
    gunichar            clutter_text_get_password_char      (ClutterText *self);

    Retrieves the character to use in place of the actual text as set by clutter_text_set_password_char().

    +

    +

    @@ -911,12 +1202,16 @@

    clutter_text_set_justify ()

    -
    void                clutter_text_set_justify            (ClutterText *self,
    -                                                         gboolean justify);
    +
    void                clutter_text_set_justify            (ClutterText *self,
    +                                                         gboolean justify);

    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.

    +

    +

    @@ -937,10 +1232,14 @@

    clutter_text_get_justify ()

    -
    gboolean            clutter_text_get_justify            (ClutterText *self);
    +
    gboolean            clutter_text_get_justify            (ClutterText *self);

    Retrieves whether the ClutterText actor should justify its contents on both margins.

    +

    +

    @@ -951,7 +1250,7 @@ - @@ -962,9 +1261,15 @@

    clutter_text_get_layout ()

    -
    PangoLayout *       clutter_text_get_layout             (ClutterText *self);
    +
    PangoLayout *       clutter_text_get_layout             (ClutterText *self);

    -Retrieves the current PangoLayout used by a ClutterText actor.

    +Retrieves the current PangoLayout used by a ClutterText actor.

    +

    +

    Returns :

    TRUE if the text should be justified + TRUE if the text should be justified
    @@ -975,7 +1280,7 @@ - +

    Returns :

    transfer none. transfer none. transfer none. transfer none.
    @@ -984,8 +1289,10 @@

    clutter_text_set_line_alignment ()

    -
    void                clutter_text_set_line_alignment     (ClutterText *self,
    -                                                         PangoAlignment alignment);
    +
    void                clutter_text_set_line_alignment     (ClutterText *self,
    +                                                         PangoAlignment alignment);

    Sets the way that the lines of a wrapped label are aligned with respect to each other. This does not affect the overall alignment @@ -994,6 +1301,8 @@

    To align a ClutterText actor you should add it to a container that supports alignment, or use the anchor point.

    +

    +

    @@ -1004,7 +1313,9 @@ - @@ -1014,10 +1325,14 @@

    clutter_text_get_line_alignment ()

    -
    PangoAlignment      clutter_text_get_line_alignment     (ClutterText *self);
    +
    PangoAlignment      clutter_text_get_line_alignment     (ClutterText *self);

    Retrieves the alignment of a ClutterText, as set by clutter_text_set_line_alignment().

    +

    +

    alignment :

    A PangoAlignment + A PangoAlignment
    @@ -1028,7 +1343,9 @@ - @@ -1039,11 +1356,15 @@

    clutter_text_set_line_wrap ()

    -
    void                clutter_text_set_line_wrap          (ClutterText *self,
    -                                                         gboolean line_wrap);
    +
    void                clutter_text_set_line_wrap          (ClutterText *self,
    +                                                         gboolean line_wrap);

    Sets whether the contents of a ClutterText actor should wrap, if they don't fit the size assigned to the actor.

    +

    +

    Returns :

    a PangoAlignment + a PangoAlignment
    @@ -1064,9 +1385,13 @@

    clutter_text_get_line_wrap ()

    -
    gboolean            clutter_text_get_line_wrap          (ClutterText *self);
    +
    gboolean            clutter_text_get_line_wrap          (ClutterText *self);

    Retrieves the value set using clutter_text_set_line_wrap().

    +

    +

    @@ -1077,7 +1402,7 @@ - @@ -1089,12 +1414,16 @@

    clutter_text_set_line_wrap_mode ()

    -
    void                clutter_text_set_line_wrap_mode     (ClutterText *self,
    -                                                         PangoWrapMode wrap_mode);
    +
    void                clutter_text_set_line_wrap_mode     (ClutterText *self,
    +                                                         PangoWrapMode wrap_mode);

    If line wrapping is enabled (see clutter_text_set_line_wrap()) this function controls how the line wrapping is performed. The default is PANGO_WRAP_WORD which means wrap on word boundaries.

    +

    +

    Returns :

    TRUE if the ClutterText actor should wrap + TRUE if the ClutterText actor should wrap its contents
    @@ -1115,12 +1444,16 @@

    clutter_text_get_line_wrap_mode ()

    -
    PangoWrapMode       clutter_text_get_line_wrap_mode     (ClutterText *self);
    +
    PangoWrapMode       clutter_text_get_line_wrap_mode     (ClutterText *self);

    Retrieves the line wrap mode used by the ClutterText actor.

    See clutter_text_set_line_wrap_mode().

    +

    +

    @@ -1142,12 +1475,16 @@

    clutter_text_set_max_length ()

    -
    void                clutter_text_set_max_length         (ClutterText *self,
    -                                                         gint max);
    +
    void                clutter_text_set_max_length         (ClutterText *self,
    +                                                         gint max);

    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.

    +

    +

    @@ -1169,12 +1506,16 @@

    clutter_text_get_max_length ()

    -
    gint                clutter_text_get_max_length         (ClutterText *self);
    +
    gint                clutter_text_get_max_length         (ClutterText *self);

    Gets the maximum length of text that can be set into a text actor.

    See clutter_text_set_max_length().

    +

    +

    @@ -1196,14 +1537,18 @@

    clutter_text_set_selectable ()

    -
    void                clutter_text_set_selectable         (ClutterText *self,
    -                                                         gboolean selectable);
    +
    void                clutter_text_set_selectable         (ClutterText *self,
    +                                                         gboolean selectable);

    Sets whether a ClutterText actor should be selectable.

    A selectable ClutterText will allow selecting its contents using the pointer or the keyboard.

    +

    +

    @@ -1224,9 +1569,13 @@

    clutter_text_get_selectable ()

    -
    gboolean            clutter_text_get_selectable         (ClutterText *self);
    +
    gboolean            clutter_text_get_selectable         (ClutterText *self);

    Retrieves whether a ClutterText is selectable or not.

    +

    +

    @@ -1237,7 +1586,7 @@ - @@ -1248,15 +1597,21 @@

    clutter_text_set_selection ()

    -
    void                clutter_text_set_selection          (ClutterText *self,
    -                                                         gssize start_pos,
    -                                                         gssize end_pos);
    +
    void                clutter_text_set_selection          (ClutterText *self,
    +                                                         gssize start_pos,
    +                                                         gssize end_pos);

    Selects the region of text between start_pos and end_pos.

    This function changes the position of the cursor to match start_pos and the selection bound to match end_pos.

    +

    +

    Returns :

    TRUE if the actor is selectable + TRUE if the actor is selectable
    @@ -1282,9 +1637,13 @@

    clutter_text_get_selection ()

    -
    gchar *             clutter_text_get_selection          (ClutterText *self);
    +
    gchar *             clutter_text_get_selection          (ClutterText *self);

    Retrieves the currently selected text.

    +

    +

    @@ -1296,7 +1655,9 @@ @@ -1308,14 +1669,18 @@

    clutter_text_set_selection_bound ()

    -
    void                clutter_text_set_selection_bound    (ClutterText *self,
    -                                                         gint selection_bound);
    +
    void                clutter_text_set_selection_bound    (ClutterText *self,
    +                                                         gint selection_bound);

    Sets the other end of the selection, starting from the current cursor position.

    If selection_bound is -1, the selection unset.

    +

    +

    Returns :

    a newly allocated string containing the currently - selected text, or NULL. Use g_free() to free the returned + selected text, or NULL. Use g_free() to free the returned string.
    @@ -1336,10 +1701,14 @@

    clutter_text_get_selection_bound ()

    -
    gint                clutter_text_get_selection_bound    (ClutterText *self);
    +
    gint                clutter_text_get_selection_bound    (ClutterText *self);

    Retrieves the other end of the selection of a ClutterText actor, in characters from the current cursor position.

    +

    +

    @@ -1361,8 +1730,10 @@

    clutter_text_set_single_line_mode ()

    -
    void                clutter_text_set_single_line_mode   (ClutterText *self,
    -                                                         gboolean single_line);
    +
    void                clutter_text_set_single_line_mode   (ClutterText *self,
    +                                                         gboolean single_line);

    Sets whether a ClutterText actor should be in single line mode or not. @@ -1378,6 +1749,8 @@ property is also set as a side effect. Instead of entering a new line character, the text actor will emit the "activate" signal.

    +

    +

    @@ -1398,9 +1771,13 @@

    clutter_text_get_single_line_mode ()

    -
    gboolean            clutter_text_get_single_line_mode   (ClutterText *self);
    +
    gboolean            clutter_text_get_single_line_mode   (ClutterText *self);

    Retrieves whether the ClutterText actor is in single line mode.

    +

    +

    @@ -1411,7 +1788,7 @@ - @@ -1422,15 +1799,21 @@

    clutter_text_set_use_markup ()

    -
    void                clutter_text_set_use_markup         (ClutterText *self,
    -                                                         gboolean setting);
    +
    void                clutter_text_set_use_markup         (ClutterText *self,
    +                                                         gboolean setting);

    Sets whether the contents of the ClutterText actor contains markup -in Pango's text markup language. +in Pango's text markup language.

    Setting "use-markup" on an editable ClutterText will make the actor discard any markup.

    +

    +

    Returns :

    TRUE if the ClutterText actor is in single line mode + TRUE if the ClutterText actor is in single line mode
    @@ -1441,7 +1824,7 @@ - @@ -1451,10 +1834,14 @@

    clutter_text_get_use_markup ()

    -
    gboolean            clutter_text_get_use_markup         (ClutterText *self);
    +
    gboolean            clutter_text_get_use_markup         (ClutterText *self);

    Retrieves whether the contents of the ClutterText actor should be parsed for the Pango text markup.

    +

    +

    setting :

    TRUE if the text should be parsed for markup. + TRUE if the text should be parsed for markup.
    @@ -1465,7 +1852,7 @@ - @@ -1476,8 +1863,10 @@

    clutter_text_set_editable ()

    -
    void                clutter_text_set_editable           (ClutterText *self,
    -                                                         gboolean editable);
    +
    void                clutter_text_set_editable           (ClutterText *self,
    +                                                         gboolean editable);

    Sets whether the ClutterText actor should be editable.

    @@ -1485,6 +1874,8 @@ An editable ClutterText with key focus set using clutter_actor_grab_key_focus() or clutter_stage_take_key_focus() will receive key events and will update its contents accordingly.

    +

    +

    Returns :

    TRUE if the contents will be parsed for markup + TRUE if the contents will be parsed for markup
    @@ -1505,9 +1896,13 @@

    clutter_text_get_editable ()

    -
    gboolean            clutter_text_get_editable           (ClutterText *self);
    +
    gboolean            clutter_text_get_editable           (ClutterText *self);

    Retrieves whether a ClutterText is editable or not.

    +

    +

    @@ -1518,7 +1913,7 @@ - @@ -1529,9 +1924,13 @@

    clutter_text_insert_text ()

    -
    void                clutter_text_insert_text            (ClutterText *self,
    -                                                         const gchar *text,
    -                                                         gssize position);
    +
    void                clutter_text_insert_text            (ClutterText *self,
    +                                                         const gchar *text,
    +                                                         gssize position);

    Inserts text into a ClutterActor at the given position.

    @@ -1541,6 +1940,8 @@

    The position is expressed in characters, not in bytes.

    +

    +

    Returns :

    TRUE if the actor is editable + TRUE if the actor is editable
    @@ -1566,11 +1967,15 @@

    clutter_text_insert_unichar ()

    -
    void                clutter_text_insert_unichar         (ClutterText *self,
    -                                                         gunichar wc);
    +
    void                clutter_text_insert_unichar         (ClutterText *self,
    +                                                         gunichar wc);

    Inserts wc at the current cursor position of a ClutterText actor.

    +

    +

    @@ -1591,11 +1996,15 @@

    clutter_text_delete_chars ()

    -
    void                clutter_text_delete_chars           (ClutterText *self,
    -                                                         guint n_chars);
    +
    void                clutter_text_delete_chars           (ClutterText *self,
    +                                                         guint n_chars);

    Deletes n_chars inside a ClutterText actor, starting from the current cursor position.

    +

    +

    @@ -1616,9 +2025,13 @@

    clutter_text_delete_text ()

    -
    void                clutter_text_delete_text            (ClutterText *self,
    -                                                         gssize start_pos,
    -                                                         gssize end_pos);
    +
    void                clutter_text_delete_text            (ClutterText *self,
    +                                                         gssize start_pos,
    +                                                         gssize end_pos);

    Deletes the text inside a ClutterText actor between start_pos and end_pos. @@ -1626,6 +2039,8 @@

    The starting and ending positions are expressed in characters, not in bytes.

    +

    +

    @@ -1651,12 +2066,16 @@

    clutter_text_delete_selection ()

    -
    gboolean            clutter_text_delete_selection       (ClutterText *self);
    +
    gboolean            clutter_text_delete_selection       (ClutterText *self);

    Deletes the currently selected text

    This function is only useful in subclasses of ClutterText

    +

    +

    @@ -1667,8 +2086,8 @@ - @@ -1679,15 +2098,23 @@

    clutter_text_get_chars ()

    -
    gchar *             clutter_text_get_chars              (ClutterText *self,
    -                                                         gssize start_pos,
    -                                                         gssize end_pos);
    +
    gchar *             clutter_text_get_chars              (ClutterText *self,
    +                                                         gssize start_pos,
    +                                                         gssize end_pos);

    Retrieves the contents of the ClutterText actor between start_pos and end_pos.

    The positions are specified in characters, not in bytes.

    +

    +

    Returns :

    TRUE if text was deleted or if the text actor - is empty, and FALSE otherwise + TRUE if text was deleted or if the text actor + is empty, and FALSE otherwise
    @@ -1709,7 +2136,9 @@ @@ -1721,14 +2150,16 @@

    clutter_text_set_cursor_color ()

    -
    void                clutter_text_set_cursor_color       (ClutterText *self,
    -                                                         const ClutterColor *color);
    +
    void                clutter_text_set_cursor_color       (ClutterText *self,
    +                                                         const ClutterColor *color);

    Sets the color of the cursor of a ClutterText actor.

    -If color is NULL, the cursor color will be the same as the +If color is NULL, the cursor color will be the same as the text color.

    +

    +

    Returns :

    a newly allocated string with the contents of - the text actor between the specified positions. Use g_free() + the text actor between the specified positions. Use g_free() to free the resources when done
    @@ -1739,7 +2170,7 @@ - @@ -1749,10 +2180,12 @@

    clutter_text_get_cursor_color ()

    -
    void                clutter_text_get_cursor_color       (ClutterText *self,
    -                                                         ClutterColor *color);
    +
    void                clutter_text_get_cursor_color       (ClutterText *self,
    +                                                         ClutterColor *color);

    Retrieves the color of the cursor of a ClutterText actor.

    +

    +

    color :

    the color of the cursor, or NULL to unset it + the color of the cursor, or NULL to unset it
    @@ -1773,15 +2206,17 @@

    clutter_text_set_selection_color ()

    -
    void                clutter_text_set_selection_color    (ClutterText *self,
    -                                                         const ClutterColor *color);
    +
    void                clutter_text_set_selection_color    (ClutterText *self,
    +                                                         const ClutterColor *color);

    Sets the color of the selection of a ClutterText actor.

    -If color is NULL, the selection color will be the same as the +If color is NULL, the selection color will be the same as the cursor color, or if no cursor color is set either then it will be the same as the text color.

    +

    +

    @@ -1792,7 +2227,7 @@ - @@ -1802,10 +2237,12 @@

    clutter_text_get_selection_color ()

    -
    void                clutter_text_get_selection_color    (ClutterText *self,
    -                                                         ClutterColor *color);
    +
    void                clutter_text_get_selection_color    (ClutterText *self,
    +                                                         ClutterColor *color);

    Retrieves the color of the selection of a ClutterText actor.

    +

    +

    color :

    the color of the selection, or NULL to unset it + the color of the selection, or NULL to unset it
    @@ -1826,13 +2263,17 @@

    clutter_text_set_cursor_position ()

    -
    void                clutter_text_set_cursor_position    (ClutterText *self,
    -                                                         gint position);
    +
    void                clutter_text_set_cursor_position    (ClutterText *self,
    +                                                         gint position);

    Sets the cursor of a ClutterText actor at position.

    The position is expressed in characters, not in bytes.

    +

    +

    @@ -1853,9 +2294,13 @@

    clutter_text_get_cursor_position ()

    -
    gint                clutter_text_get_cursor_position    (ClutterText *self);
    +
    gint                clutter_text_get_cursor_position    (ClutterText *self);

    Retrieves the cursor position.

    +

    +

    @@ -1877,8 +2322,10 @@

    clutter_text_set_cursor_visible ()

    -
    void                clutter_text_set_cursor_visible     (ClutterText *self,
    -                                                         gboolean cursor_visible);
    +
    void                clutter_text_set_cursor_visible     (ClutterText *self,
    +                                                         gboolean cursor_visible);

    Sets whether the cursor of a ClutterText actor should be visible or not. @@ -1893,6 +2340,8 @@

    The position of the cursor can be changed programmatically using clutter_text_set_cursor_position().

    +

    +

    @@ -1913,9 +2362,13 @@

    clutter_text_get_cursor_visible ()

    -
    gboolean            clutter_text_get_cursor_visible     (ClutterText *self);
    +
    gboolean            clutter_text_get_cursor_visible     (ClutterText *self);

    Retrieves whether the cursor of a ClutterText actor is visible.

    +

    +

    @@ -1926,7 +2379,7 @@ - @@ -1937,12 +2390,16 @@

    clutter_text_set_cursor_size ()

    -
    void                clutter_text_set_cursor_size        (ClutterText *self,
    -                                                         gint size);
    +
    void                clutter_text_set_cursor_size        (ClutterText *self,
    +                                                         gint size);

    Sets the size of the cursor of a ClutterText. The cursor will only be visible if the "cursor-visible" property -is set to TRUE.

    +is set to TRUE.

    +

    +

    Returns :

    TRUE if the cursor is visible + TRUE if the cursor is visible
    @@ -1964,9 +2421,13 @@

    clutter_text_get_cursor_size ()

    -
    guint               clutter_text_get_cursor_size        (ClutterText *self);
    +
    guint               clutter_text_get_cursor_size        (ClutterText *self);

    Retrieves the size of the cursor of a ClutterText actor.

    +

    +

    @@ -1988,7 +2449,9 @@

    clutter_text_activate ()

    -
    gboolean            clutter_text_activate               (ClutterText *self);
    +
    gboolean            clutter_text_activate               (ClutterText *self);

    Emits the "activate" signal, if self has been set as activatable using clutter_text_set_activatable(). @@ -1998,6 +2461,8 @@ a "captured-event" or "key-press-event" signal handlers before the default signal handler for the ClutterText is invoked.

    +

    +

    @@ -2008,8 +2473,8 @@ - @@ -2020,13 +2485,25 @@

    clutter_text_position_to_coords ()

    -
    gboolean            clutter_text_position_to_coords     (ClutterText *self,
    -                                                         gint position,
    -                                                         gfloat *x,
    -                                                         gfloat *y,
    -                                                         gfloat *line_height);
    +
    gboolean            clutter_text_position_to_coords     (ClutterText *self,
    +                                                         gint position,
    +                                                         gfloat *x,
    +                                                         gfloat *y,
    +                                                         gfloat *line_height);

    Retrieves the coordinates of the given position.

    +

    +

    Returns :

    TRUE if the ::activate signal has been emitted, - and FALSE otherwise + TRUE if the ::activate signal has been emitted, + and FALSE otherwise
    @@ -2042,22 +2519,22 @@ - - - - @@ -2068,10 +2545,16 @@

    clutter_text_set_preedit_string ()

    -
    void                clutter_text_set_preedit_string     (ClutterText *self,
    -                                                         const gchar *preedit_str,
    -                                                         PangoAttrList *preedit_attrs,
    -                                                         guint cursor_pos);
    +
    void                clutter_text_set_preedit_string     (ClutterText *self,
    +                                                         const gchar *preedit_str,
    +                                                         PangoAttrList *preedit_attrs,
    +                                                         guint cursor_pos);

    Sets, or unsets, the pre-edit string. This function is useful for input methods to display a string (with eventual specific @@ -2084,6 +2567,8 @@

    This function should not be used by applications

    +

    +

    x :

    return location for the X coordinate, or NULL + return location for the X coordinate, or NULL

    y :

    return location for the Y coordinate, or NULL + return location for the Y coordinate, or NULL

    line_height :

    return location for the line height, or NULL + return location for the line height, or NULL

    Returns :

    TRUE if the conversion was successful + TRUE if the conversion was successful
    @@ -2094,11 +2579,11 @@ - + - + @@ -2114,220 +2599,308 @@

    Property Details

    The "activatable" property

    -
      "activatable"              gboolean              : Read / Write
    +
      "activatable"              gboolean              : Read / Write

    Toggles whether return invokes the activate signal or not.

    +

    +

    Default value: TRUE

    -

    Since 1.0

    +

    Since 1.0


    The "attributes" property

    -
      "attributes"               PangoAttrList*        : Read / Write
    +
      "attributes"               PangoAttrList*        : Read / Write

    A list of PangoStyleAttributes to be applied to the contents of the ClutterText actor.

    -

    Since 1.0

    +

    +

    +

    Since 1.0


    The "color" property

    -
      "color"                    ClutterColor*         : Read / Write
    +
      "color"                    ClutterColor*         : Read / Write

    The color used to render the text.

    -

    Since 1.0

    +

    +

    +

    Since 1.0


    The "cursor-color" property

    -
      "cursor-color"             ClutterColor*         : Read / Write
    +
      "cursor-color"             ClutterColor*         : Read / Write

    The color of the cursor.

    -

    Since 1.0

    +

    +

    +

    Since 1.0


    The "cursor-color-set" property

    -
      "cursor-color-set"         gboolean              : Read
    +
      "cursor-color-set"         gboolean              : Read
    +

    +Will be set to TRUE if "cursor-color" has been set.

    -Will be set to TRUE if "cursor-color" has been set.

    +

    Default value: FALSE

    -

    Since 1.0

    +

    Since 1.0


    The "cursor-size" property

    -
      "cursor-size"              gint                  : Read / Write
    +
      "cursor-size"              gint                  : Read / Write

    The size of the cursor, in pixels. If set to -1 the size used will be the default cursor size of 2 pixels.

    +

    +

    Allowed values: >= -1

    Default value: 2

    -

    Since 1.0

    +

    Since 1.0


    The "cursor-visible" property

    -
      "cursor-visible"           gboolean              : Read / Write
    +
      "cursor-visible"           gboolean              : Read / Write

    Whether the input cursor is visible or not, it will only be visible if both "cursor-visible" and "editable" are -set to TRUE.

    +set to TRUE.

    +

    +

    Default value: TRUE

    -

    Since 1.0

    +

    Since 1.0


    The "editable" property

    -
      "editable"                 gboolean              : Read / Write
    +
      "editable"                 gboolean              : Read / Write

    Whether key events delivered to the actor causes editing.

    +

    +

    Default value: TRUE

    -

    Since 1.0

    +

    Since 1.0


    The "ellipsize" property

    -
      "ellipsize"                PangoEllipsizeMode    : Read / Write
    +
      "ellipsize"                PangoEllipsizeMode    : Read / Write

    The preferred place to ellipsize the contents of the ClutterText actor

    +

    +

    Default value: PANGO_ELLIPSIZE_NONE

    -

    Since 1.0

    +

    Since 1.0


    The "font-description" property

    -
      "font-description"         PangoFontDescription*  : Read / Write
    -

    -The PangoFontDescription that should be used by the ClutterText +

      "font-description"         PangoFontDescription*  : Read / Write
    +

    +The PangoFontDescription that should be used by the ClutterText

    If you have a string describing the font then you should look at "font-name" instead

    -

    Since 1.2

    +

    +

    +

    Since 1.2


    The "font-name" property

    -
      "font-name"                gchar*                : Read / Write
    +
      "font-name"                gchar*                : Read / Write

    The font to be used by the ClutterText, as a string -that can be parsed by pango_font_description_from_string().

    +that can be parsed by pango_font_description_from_string().

    +

    +

    Default value: NULL

    -

    Since 1.0

    +

    Since 1.0


    The "justify" property

    -
      "justify"                  gboolean              : Read / Write
    +
      "justify"                  gboolean              : Read / Write

    Whether the contents of the ClutterText should be justified on both margins.

    +

    +

    Default value: FALSE

    -

    Since 1.0

    +

    Since 1.0


    The "line-alignment" property

    -
      "line-alignment"           PangoAlignment        : Read / Write
    +
      "line-alignment"           PangoAlignment        : Read / Write

    The preferred alignment for the text. This property controls the alignment of multi-line paragraphs.

    +

    +

    Default value: PANGO_ALIGN_LEFT

    -

    Since 1.0

    +

    Since 1.0


    The "line-wrap" property

    -
      "line-wrap"                gboolean              : Read / Write
    +
      "line-wrap"                gboolean              : Read / Write

    Whether to wrap the lines of "text" if the contents exceed the available allocation. The wrapping strategy is controlled by the "line-wrap-mode" property.

    +

    +

    Default value: FALSE

    -

    Since 1.0

    +

    Since 1.0


    The "line-wrap-mode" property

    -
      "line-wrap-mode"           PangoWrapMode         : Read / Write
    +
      "line-wrap-mode"           PangoWrapMode         : Read / Write

    -If "line-wrap" is set to TRUE, this property will +If "line-wrap" is set to TRUE, this property will control how the text is wrapped.

    +

    +

    Default value: PANGO_WRAP_WORD

    -

    Since 1.0

    +

    Since 1.0


    The "max-length" property

    -
      "max-length"               gint                  : Read / Write
    +
      "max-length"               gint                  : Read / Write

    The maximum length of the contents of the ClutterText actor.

    +

    +

    Allowed values: >= -1

    Default value: 0

    -

    Since 1.0

    +

    Since 1.0


    The "password-char" property

    -
      "password-char"            guint                 : Read / Write
    +
      "password-char"            guint                 : Read / Write

    If non-zero, the character that should be used in place of the actual text in a password text actor.

    +

    +

    Default value: 0

    -

    Since 1.0

    +

    Since 1.0


    The "position" property

    -
      "position"                 gint                  : Read / Write
    +
      "position"                 gint                  : Read / Write

    The current input cursor position. -1 is taken to be the end of the text

    +

    +

    Allowed values: >= -1

    Default value: -1

    -

    Since 1.0

    +

    Since 1.0


    The "selectable" property

    -
      "selectable"               gboolean              : Read / Write
    +
      "selectable"               gboolean              : Read / Write

    Whether it is possible to select text, either using the pointer or the keyboard.

    +

    +

    Default value: TRUE

    -

    Since 1.0

    +

    Since 1.0


    The "selection-bound" property

    -
      "selection-bound"          gint                  : Read / Write
    +
      "selection-bound"          gint                  : Read / Write

    The current input cursor position. -1 is taken to be the end of the text

    +

    +

    Allowed values: >= -1

    Default value: -1

    -

    Since 1.0

    +

    Since 1.0


    The "selection-color" property

    -
      "selection-color"          ClutterColor*         : Read / Write
    +
      "selection-color"          ClutterColor*         : Read / Write

    The color of the selection.

    -

    Since 1.0

    +

    +

    +

    Since 1.0


    The "selection-color-set" property

    -
      "selection-color-set"      gboolean              : Read
    +
      "selection-color-set"      gboolean              : Read
    +

    +Will be set to TRUE if "selection-color" has been set.

    -Will be set to TRUE if "selection-color" has been set.

    +

    Default value: FALSE

    -

    Since 1.0

    +

    Since 1.0


    The "single-line-mode" property

    -
      "single-line-mode"         gboolean              : Read / Write
    +
      "single-line-mode"         gboolean              : Read / Write

    Whether the ClutterText actor should be in single line mode or not. A single line ClutterText actor will only contain a @@ -2337,39 +2910,55 @@

    Setting this property will also set the "activatable" property as a side-effect.

    +

    +

    Default value: FALSE

    -

    Since 1.0

    +

    Since 1.0


    The "text" property

    -
      "text"                     gchar*                : Read / Write
    +
      "text"                     gchar*                : Read / Write

    The text to render inside the actor.

    +

    +

    Default value: ""

    -

    Since 1.0

    +

    Since 1.0


    The "use-markup" property

    -
      "use-markup"               gboolean              : Read / Write
    -

    -Whether the text includes Pango markup. See pango_layout_set_markup() +

      "use-markup"               gboolean              : Read / Write
    +

    +Whether the text includes Pango markup. See pango_layout_set_markup() in the Pango documentation.

    +

    +

    Default value: FALSE

    -

    Since 1.0

    +

    Since 1.0

    Signal Details

    The "activate" signal

    -
    void                user_function                      (ClutterText *self,
    -                                                        gpointer     user_data)      : Run Last
    +
    void                user_function                      (ClutterText *self,
    +                                                        gpointer     user_data)      : Run Last

    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 "activatable" is set to TRUE.

    +emitted only if "activatable" is set to TRUE.

    +

    +

    preedit_str :

    the pre-edit string, or NULL to unset it. allow-none. the pre-edit string, or NULL to unset it. allow-none.

    preedit_attrs :

    the pre-edit string attributes. allow-none. the pre-edit string attributes. allow-none.

    cursor_pos :

    @@ -2384,19 +2973,23 @@
    -

    Since 1.0

    +

    Since 1.0


    The "cursor-event" signal

    -
    void                user_function                      (ClutterText     *self,
    -                                                        ClutterGeometry *geometry,
    -                                                        gpointer         user_data)      : Run Last
    +
    void                user_function                      (ClutterText     *self,
    +                                                        ClutterGeometry *geometry,
    +                                                        gpointer         user_data)      : Run Last

    The ::cursor-event signal is emitted whenever the cursor position changes inside a ClutterText actor. Inside geometry it is stored the current position and size of the cursor, relative to the actor itself.

    +

    +

    @@ -2416,18 +3009,26 @@
    -

    Since 1.0

    +

    Since 1.0


    The "delete-text" signal

    -
    void                user_function                      (ClutterText *self,
    -                                                        gint         start_pos,
    -                                                        gint         end_pos,
    -                                                        gpointer     user_data)      : Run Last / Action
    +
    void                user_function                      (ClutterText *self,
    +                                                        gint         start_pos,
    +                                                        gint         end_pos,
    +                                                        gpointer     user_data)      : Run Last / Action

    This signal is emitted when text is deleted from the actor by the user. It is emitted before self text changes.

    +

    +

    @@ -2452,19 +3053,29 @@
    -

    Since 1.2

    +

    Since 1.2


    The "insert-text" signal

    -
    void                user_function                      (ClutterText *self,
    -                                                        gchar       *new_text,
    -                                                        gint         new_text_length,
    -                                                        gpointer     position,
    -                                                        gpointer     user_data)            : Run Last / Action
    +
    void                user_function                      (ClutterText *self,
    +                                                        gchar       *new_text,
    +                                                        gint         new_text_length,
    +                                                        gpointer     position,
    +                                                        gpointer     user_data)            : Run Last / Action

    This signal is emitted when text is inserted into the actor by the user. It is emitted before self text changes.

    +

    +

    @@ -2498,15 +3109,19 @@
    -

    Since 1.2

    +

    Since 1.2


    The "text-changed" signal

    -
    void                user_function                      (ClutterText *self,
    -                                                        gpointer     user_data)      : Run Last
    +
    void                user_function                      (ClutterText *self,
    +                                                        gpointer     user_data)      : Run Last

    The ::text-changed signal is emitted after actor's text changes

    +

    +

    @@ -2521,12 +3136,12 @@
    -

    Since 1.0

    +

    Since 1.0

    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ClutterRectangle.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ClutterRectangle.html @@ -8,7 +8,7 @@ - + @@ -62,14 +62,14 @@ Top -  |  - Description -  |  - Object Hierarchy -  |  - Implemented Interfaces -  |  - Properties +  |  + Description +  |  + Object Hierarchy +  |  + Implemented Interfaces +  |  + Properties
    @@ -83,28 +83,37 @@

    Object Hierarchy

    -  GObject
    -   +----GInitiallyUnowned
    +  GObject
    +   +----GInitiallyUnowned
              +----ClutterActor
                    +----ClutterRectangle
     
    @@ -118,16 +127,22 @@

    Properties

    -  "border-color"             ClutterColor*         : Read / Write
    -  "border-width"             guint                 : Read / Write
    -  "color"                    ClutterColor*         : Read / Write
    -  "has-border"               gboolean              : Read / Write
    +  "border-color"             ClutterColor*         : Read / Write
    +  "border-width"             guint                 : Read / Write
    +  "color"                    ClutterColor*         : Read / Write
    +  "has-border"               gboolean              : Read / Write
     

    Description

    ClutterRectangle is a ClutterActor which draws a simple filled rectangle.

    +

    +

    Details

    @@ -137,6 +152,8 @@

    The ClutterRectangle structure contains only private data and should be accessed using the provided API

    +

    +

    Since 0.1


    @@ -147,14 +164,18 @@

    The ClutterRectangleClass structure contains only private data

    +

    +

    Since 0.1


    clutter_rectangle_new ()

    -
    ClutterActor *      clutter_rectangle_new               (void);
    +
    ClutterActor *      clutter_rectangle_new               (void);

    Creates a new ClutterActor with a rectangular shape.

    +

    +

    @@ -167,10 +188,12 @@

    clutter_rectangle_new_with_color ()

    -
    ClutterActor *      clutter_rectangle_new_with_color    (const ClutterColor *color);
    +
    ClutterActor *      clutter_rectangle_new_with_color    (const ClutterColor *color);

    Creates a new ClutterActor with a rectangular shape and of the given color.

    +

    +

    @@ -190,10 +213,12 @@

    clutter_rectangle_get_color ()

    -
    void                clutter_rectangle_get_color         (ClutterRectangle *rectangle,
    -                                                         ClutterColor *color);
    +
    void                clutter_rectangle_get_color         (ClutterRectangle *rectangle,
    +                                                         ClutterColor *color);

    Retrieves the color of rectangle.

    +

    +

    @@ -213,10 +238,12 @@

    clutter_rectangle_set_color ()

    -
    void                clutter_rectangle_set_color         (ClutterRectangle *rectangle,
    -                                                         const ClutterColor *color);
    +
    void                clutter_rectangle_set_color         (ClutterRectangle *rectangle,
    +                                                         const ClutterColor *color);

    Sets the color of rectangle.

    +

    +

    @@ -236,11 +263,13 @@

    clutter_rectangle_get_border_color ()

    -
    void                clutter_rectangle_get_border_color  (ClutterRectangle *rectangle,
    -                                                         ClutterColor *color);
    +
    void                clutter_rectangle_get_border_color  (ClutterRectangle *rectangle,
    +                                                         ClutterColor *color);

    Gets the color of the border used by rectangle and places it into color.

    +

    +

    @@ -261,10 +290,12 @@

    clutter_rectangle_set_border_color ()

    -
    void                clutter_rectangle_set_border_color  (ClutterRectangle *rectangle,
    -                                                         const ClutterColor *color);
    +
    void                clutter_rectangle_set_border_color  (ClutterRectangle *rectangle,
    +                                                         const ClutterColor *color);

    Sets the color of the border used by rectangle using color

    +

    +

    @@ -284,9 +315,13 @@

    clutter_rectangle_get_border_width ()

    -
    guint               clutter_rectangle_get_border_width  (ClutterRectangle *rectangle);
    +
    guint               clutter_rectangle_get_border_width  (ClutterRectangle *rectangle);

    Gets the width (in pixels) of the border used by rectangle

    +

    +

    @@ -308,11 +343,15 @@

    clutter_rectangle_set_border_width ()

    -
    void                clutter_rectangle_set_border_width  (ClutterRectangle *rectangle,
    -                                                         guint width);
    +
    void                clutter_rectangle_set_border_width  (ClutterRectangle *rectangle,
    +                                                         guint width);

    Sets the width (in pixel) of the border used by rectangle. A width of 0 will unset the border.

    +

    +

    @@ -335,40 +374,52 @@

    Property Details

    The "border-color" property

    -
      "border-color"             ClutterColor*         : Read / Write
    +
      "border-color"             ClutterColor*         : Read / Write

    The color of the border of the rectangle.

    -

    Since 0.2

    +

    +

    +

    Since 0.2


    The "border-width" property

    -
      "border-width"             guint                 : Read / Write
    +
      "border-width"             guint                 : Read / Write

    The width of the border of the rectangle, in pixels.

    +

    +

    Default value: 0

    -

    Since 0.2

    +

    Since 0.2


    The "color" property

    -
      "color"                    ClutterColor*         : Read / Write
    +
      "color"                    ClutterColor*         : Read / Write

    The color of the rectangle.

    +

    +


    The "has-border" property

    -
      "has-border"               gboolean              : Read / Write
    +
      "has-border"               gboolean              : Read / Write

    Whether the ClutterRectangle should be displayed with a border.

    +

    +

    Default value: FALSE

    -

    Since 0.2

    +

    Since 0.2

    + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ClutterMedia.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ClutterMedia.html @@ -8,7 +8,7 @@ - + @@ -62,14 +62,14 @@
    Top -  |  - Description -  |  - Object Hierarchy -  |  - Properties -  |  - Signals +  |  + Description +  |  + Object Hierarchy +  |  + Properties +  |  + Signals
    @@ -83,33 +83,64 @@

    Synopsis

    -
                        ClutterMedia;
    +
    +                    ClutterMedia;
                         ClutterMediaIface;
    -void                clutter_media_set_uri               (ClutterMedia *media,
    -                                                         const gchar *uri);
    -gchar *             clutter_media_get_uri               (ClutterMedia *media);
    -void                clutter_media_set_playing           (ClutterMedia *media,
    -                                                         gboolean playing);
    -gboolean            clutter_media_get_playing           (ClutterMedia *media);
    -void                clutter_media_set_progress          (ClutterMedia *media,
    -                                                         gdouble progress);
    -gdouble             clutter_media_get_progress          (ClutterMedia *media);
    -void                clutter_media_set_subtitle_uri      (ClutterMedia *media,
    -                                                         const gchar *uri);
    -gchar *             clutter_media_get_subtitle_uri      (ClutterMedia *media);
    -void                clutter_media_set_subtitle_font_name
    -                                                        (ClutterMedia *media,
    -                                                         const char *font_name);
    -gchar *             clutter_media_get_subtitle_font_name
    -                                                        (ClutterMedia *media);
    -void                clutter_media_set_audio_volume      (ClutterMedia *media,
    -                                                         gdouble volume);
    -gdouble             clutter_media_get_audio_volume      (ClutterMedia *media);
    -gboolean            clutter_media_get_can_seek          (ClutterMedia *media);
    -gdouble             clutter_media_get_buffer_fill       (ClutterMedia *media);
    -gdouble             clutter_media_get_duration          (ClutterMedia *media);
    -void                clutter_media_set_filename          (ClutterMedia *media,
    -                                                         const gchar *filename);
    +void                clutter_media_set_uri               (ClutterMedia *media,
    +                                                         const gchar *uri);
    +gchar *             clutter_media_get_uri               (ClutterMedia *media);
    +void                clutter_media_set_playing           (ClutterMedia *media,
    +                                                         gboolean playing);
    +gboolean            clutter_media_get_playing           (ClutterMedia *media);
    +void                clutter_media_set_progress          (ClutterMedia *media,
    +                                                         gdouble progress);
    +gdouble             clutter_media_get_progress          (ClutterMedia *media);
    +void                clutter_media_set_subtitle_uri      (ClutterMedia *media,
    +                                                         const gchar *uri);
    +gchar *             clutter_media_get_subtitle_uri      (ClutterMedia *media);
    +void                clutter_media_set_subtitle_font_name
    +                                                        (ClutterMedia *media,
    +                                                         const char *font_name);
    +gchar *             clutter_media_get_subtitle_font_name
    +                                                        (ClutterMedia *media);
    +void                clutter_media_set_audio_volume      (ClutterMedia *media,
    +                                                         gdouble volume);
    +gdouble             clutter_media_get_audio_volume      (ClutterMedia *media);
    +gboolean            clutter_media_get_can_seek          (ClutterMedia *media);
    +gdouble             clutter_media_get_buffer_fill       (ClutterMedia *media);
    +gdouble             clutter_media_get_duration          (ClutterMedia *media);
    +void                clutter_media_set_filename          (ClutterMedia *media,
    +                                                         const gchar *filename);
     
    @@ -122,15 +153,33 @@

    Properties

    -  "audio-volume"             gdouble               : Read / Write
    -  "buffer-fill"              gdouble               : Read
    -  "can-seek"                 gboolean              : Read
    -  "duration"                 gdouble               : Read
    -  "playing"                  gboolean              : Read / Write
    -  "progress"                 gdouble               : Read / Write
    -  "subtitle-font-name"       gchar*                : Read / Write
    -  "subtitle-uri"             gchar*                : Read / Write
    -  "uri"                      gchar*                : Read / Write
    +  "audio-volume"             gdouble               : Read / Write
    +  "buffer-fill"              gdouble               : Read
    +  "can-seek"                 gboolean              : Read
    +  "duration"                 gdouble               : Read
    +  "playing"                  gboolean              : Read / Write
    +  "progress"                 gdouble               : Read / Write
    +  "subtitle-font-name"       gchar*                : Read / Write
    +  "subtitle-uri"             gchar*                : Read / Write
    +  "uri"                      gchar*                : Read / Write
     
    @@ -152,6 +201,8 @@

    ClutterMedia is available since Clutter 0.2

    +

    +

    Details

    @@ -161,6 +212,8 @@

    ClutterMedia is an opaque structure whose members cannot be directly accessed

    +

    +

    Since 0.2


    @@ -171,6 +224,8 @@

    Interface vtable for ClutterMedia implementations

    +

    +

    @@ -180,10 +235,14 @@

    clutter_media_set_uri ()

    -
    void                clutter_media_set_uri               (ClutterMedia *media,
    -                                                         const gchar *uri);
    +
    void                clutter_media_set_uri               (ClutterMedia *media,
    +                                                         const gchar *uri);

    Sets the URI of media to uri.

    +

    +

    @@ -204,9 +263,13 @@

    clutter_media_get_uri ()

    -
    gchar *             clutter_media_get_uri               (ClutterMedia *media);
    +
    gchar *             clutter_media_get_uri               (ClutterMedia *media);

    Retrieves the URI from media.

    +

    +

    @@ -217,7 +280,9 @@ - @@ -229,10 +294,14 @@

    clutter_media_set_playing ()

    -
    void                clutter_media_set_playing           (ClutterMedia *media,
    -                                                         gboolean playing);
    +
    void                clutter_media_set_playing           (ClutterMedia *media,
    +                                                         gboolean playing);

    Starts or stops playing of media.

    +

    +

    Returns :

    the URI of the media stream. Use g_free() + the URI of the media stream. Use g_free() to free the returned string
    @@ -243,7 +312,7 @@ - @@ -253,9 +322,13 @@

    clutter_media_get_playing ()

    -
    gboolean            clutter_media_get_playing           (ClutterMedia *media);
    +
    gboolean            clutter_media_get_playing           (ClutterMedia *media);

    Retrieves the playing status of media.

    +

    +

    playing :

    TRUE to start playing + TRUE to start playing
    @@ -266,7 +339,7 @@ - @@ -277,11 +350,15 @@

    clutter_media_set_progress ()

    -
    void                clutter_media_set_progress          (ClutterMedia *media,
    -                                                         gdouble progress);
    +
    void                clutter_media_set_progress          (ClutterMedia *media,
    +                                                         gdouble progress);

    Sets the playback progress of media. The progress is a normalized value between 0.0 (begin) and 1.0 (end).

    +

    +

    Returns :

    TRUE if playing, FALSE if stopped. + TRUE if playing, FALSE if stopped.
    @@ -302,9 +379,13 @@

    clutter_media_get_progress ()

    -
    gdouble             clutter_media_get_progress          (ClutterMedia *media);
    +
    gdouble             clutter_media_get_progress          (ClutterMedia *media);

    Retrieves the playback progress of media.

    +

    +

    @@ -326,10 +407,14 @@

    clutter_media_set_subtitle_uri ()

    -
    void                clutter_media_set_subtitle_uri      (ClutterMedia *media,
    -                                                         const gchar *uri);
    +
    void                clutter_media_set_subtitle_uri      (ClutterMedia *media,
    +                                                         const gchar *uri);

    Sets the location of a subtitle file to display while playing media.

    +

    +

    @@ -350,9 +435,13 @@

    clutter_media_get_subtitle_uri ()

    -
    gchar *             clutter_media_get_subtitle_uri      (ClutterMedia *media);
    +
    gchar *             clutter_media_get_subtitle_uri      (ClutterMedia *media);

    Retrieves the URI of the subtitle file in use.

    +

    +

    @@ -363,7 +452,9 @@ - @@ -375,20 +466,24 @@

    clutter_media_set_subtitle_font_name ()

    -
    void                clutter_media_set_subtitle_font_name
    -                                                        (ClutterMedia *media,
    -                                                         const char *font_name);
    +
    void                clutter_media_set_subtitle_font_name
    +                                                        (ClutterMedia *media,
    +                                                         const char *font_name);

    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 +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: +pango_font_description_from_string() like:

       clutter_media_set_subtitle_font_name (media, "Sans 24pt");
     
    +

    +

    Returns :

    the URI of the subtitle file. Use g_free() + the URI of the subtitle file. Use g_free() to free the returned string
    @@ -399,7 +494,7 @@ - @@ -409,10 +504,14 @@

    clutter_media_get_subtitle_font_name ()

    -
    gchar *             clutter_media_get_subtitle_font_name
    -                                                        (ClutterMedia *media);
    +
    gchar *             clutter_media_get_subtitle_font_name
    +                                                        (ClutterMedia *media);

    Retrieves the font name currently used.

    +

    +

    font_name :

    a font name, or NULL to set the default font name + a font name, or NULL to set the default font name
    @@ -423,7 +522,9 @@ - @@ -435,10 +536,14 @@

    clutter_media_set_audio_volume ()

    -
    void                clutter_media_set_audio_volume      (ClutterMedia *media,
    -                                                         gdouble volume);
    +
    void                clutter_media_set_audio_volume      (ClutterMedia *media,
    +                                                         gdouble volume);

    Sets the playback volume of media to volume.

    +

    +

    Returns :

    a string containing the font name. Use g_free() + a string containing the font name. Use g_free() to free the returned string
    @@ -459,9 +564,13 @@

    clutter_media_get_audio_volume ()

    -
    gdouble             clutter_media_get_audio_volume      (ClutterMedia *media);
    +
    gdouble             clutter_media_get_audio_volume      (ClutterMedia *media);

    Retrieves the playback volume of media.

    +

    +

    @@ -483,9 +592,13 @@

    clutter_media_get_can_seek ()

    -
    gboolean            clutter_media_get_can_seek          (ClutterMedia *media);
    +
    gboolean            clutter_media_get_can_seek          (ClutterMedia *media);

    Retrieves whether media is seekable or not.

    +

    +

    @@ -496,7 +609,7 @@ - @@ -507,9 +620,13 @@

    clutter_media_get_buffer_fill ()

    -
    gdouble             clutter_media_get_buffer_fill       (ClutterMedia *media);
    +
    gdouble             clutter_media_get_buffer_fill       (ClutterMedia *media);

    Retrieves the amount of the stream that is buffered.

    +

    +

    Returns :

    TRUE if media can seek, FALSE otherwise. + TRUE if media can seek, FALSE otherwise.
    @@ -531,9 +648,13 @@

    clutter_media_get_duration ()

    -
    gdouble             clutter_media_get_duration          (ClutterMedia *media);
    +
    gdouble             clutter_media_get_duration          (ClutterMedia *media);

    Retrieves the duration of the media stream that media represents.

    +

    +

    @@ -555,10 +676,14 @@

    clutter_media_set_filename ()

    -
    void                clutter_media_set_filename          (ClutterMedia *media,
    -                                                         const gchar *filename);
    +
    void                clutter_media_set_filename          (ClutterMedia *media,
    +                                                         const gchar *filename);

    Sets the source of media using a file path.

    +

    +

    @@ -581,102 +706,144 @@

    Property Details

    The "audio-volume" property

    -
      "audio-volume"             gdouble               : Read / Write
    +
      "audio-volume"             gdouble               : Read / Write

    The volume of the audio, as a normalized value between 0.0 and 1.0.

    +

    +

    Allowed values: [0,1]

    Default value: 0.5

    -

    Since 1.0

    +

    Since 1.0


    The "buffer-fill" property

    -
      "buffer-fill"              gdouble               : Read
    +
      "buffer-fill"              gdouble               : Read

    The fill level of the buffer for the current stream, as a value between 0.0 and 1.0.

    +

    +

    Allowed values: [0,1]

    Default value: 0

    -

    Since 1.0

    +

    Since 1.0


    The "can-seek" property

    -
      "can-seek"                 gboolean              : Read
    +
      "can-seek"                 gboolean              : Read

    Whether the current stream is seekable.

    +

    +

    Default value: FALSE

    -

    Since 0.2

    +

    Since 0.2


    The "duration" property

    -
      "duration"                 gdouble               : Read
    +
      "duration"                 gdouble               : Read

    The duration of the current stream, in seconds

    +

    +

    Allowed values: >= 0

    Default value: 0

    -

    Since 0.2

    +

    Since 0.2


    The "playing" property

    -
      "playing"                  gboolean              : Read / Write
    +
      "playing"                  gboolean              : Read / Write

    Whether the ClutterMedia actor is playing.

    +

    +

    Default value: FALSE

    -

    Since 0.2

    +

    Since 0.2


    The "progress" property

    -
      "progress"                 gdouble               : Read / Write
    +
      "progress"                 gdouble               : Read / Write

    The current progress of the playback, as a normalized value between 0.0 and 1.0.

    +

    +

    Allowed values: [0,1]

    Default value: 0

    -

    Since 1.0

    +

    Since 1.0


    The "subtitle-font-name" property

    -
      "subtitle-font-name"       gchar*                : Read / Write
    +
      "subtitle-font-name"       gchar*                : Read / Write

    The font used to display subtitles. The font description has to follow the same grammar as the one recognized by -pango_font_description_from_string().

    +pango_font_description_from_string().

    +

    +

    Default value: NULL

    -

    Since 1.2

    +

    Since 1.2


    The "subtitle-uri" property

    -
      "subtitle-uri"             gchar*                : Read / Write
    +
      "subtitle-uri"             gchar*                : Read / Write

    The location of a subtitle file, expressed as a valid URI.

    +

    +

    Default value: NULL

    -

    Since 1.2

    +

    Since 1.2


    The "uri" property

    -
      "uri"                      gchar*                : Read / Write
    +
      "uri"                      gchar*                : Read / Write

    The location of a media file, expressed as a valid URI.

    +

    +

    Default value: NULL

    -

    Since 0.2

    +

    Since 0.2

    Signal Details

    The "eos" signal

    -
    void                user_function                      (ClutterMedia *media,
    -                                                        gpointer      user_data)      : Run Last
    +
    void                user_function                      (ClutterMedia *media,
    +                                                        gpointer      user_data)      : Run Last

    The ::eos signal is emitted each time the media stream ends.

    +

    +

    @@ -691,16 +858,22 @@
    -

    Since 0.2

    +

    Since 0.2


    The "error" signal

    -
    void                user_function                      (ClutterMedia *media,
    -                                                        gpointer      error,
    -                                                        gpointer      user_data)      : Run Last
    +
    void                user_function                      (ClutterMedia *media,
    +                                                        gpointer      error,
    +                                                        gpointer      user_data)      : Run Last

    The ::error signal is emitted each time an error occurred.

    +

    +

    @@ -711,7 +884,9 @@ - @@ -720,12 +895,12 @@

    error :

    the GError + the GError
    -

    Since 0.2

    +

    Since 0.2

    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ch10.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ch10.html @@ -8,7 +8,7 @@ - + @@ -61,7 +61,7 @@

    -Generic list model

    +Generic list model
    ClutterModel — A generic model implementation @@ -76,6 +76,6 @@
    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/clutter-Utilities.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/clutter-Utilities.html @@ -8,7 +8,7 @@ - + @@ -62,8 +62,8 @@ Top -  |  - Description +  |  + Description
    @@ -77,56 +77,127 @@

    Synopsis

    -
    gint                clutter_util_next_p2                (gint a);
    +
    +gint                clutter_util_next_p2                (gint a);
     
    -ClutterTimeoutPool * clutter_timeout_pool_new           (gint priority);
    -guint               clutter_timeout_pool_add            (ClutterTimeoutPool *pool,
    -                                                         guint fps,
    -                                                         GSourceFunc func,
    -                                                         gpointer data,
    -                                                         GDestroyNotify notify);
    -void                clutter_timeout_pool_remove         (ClutterTimeoutPool *pool,
    -                                                         guint id);
    +ClutterTimeoutPool * clutter_timeout_pool_new           (gint priority);
    +guint               clutter_timeout_pool_add            (ClutterTimeoutPool *pool,
    +                                                         guint fps,
    +                                                         GSourceFunc func,
    +                                                         gpointer data,
    +                                                         GDestroyNotify notify);
    +void                clutter_timeout_pool_remove         (ClutterTimeoutPool *pool,
    +                                                         guint id);
     
    -guint               clutter_frame_source_add            (guint fps,
    -                                                         GSourceFunc func,
    -                                                         gpointer data);
    -guint               clutter_frame_source_add_full       (gint priority,
    -                                                         guint fps,
    -                                                         GSourceFunc func,
    -                                                         gpointer data,
    -                                                         GDestroyNotify notify);
    +guint               clutter_frame_source_add            (guint fps,
    +                                                         GSourceFunc func,
    +                                                         gpointer data);
    +guint               clutter_frame_source_add_full       (gint priority,
    +                                                         guint fps,
    +                                                         GSourceFunc func,
    +                                                         gpointer data,
    +                                                         GDestroyNotify notify);
     
                         ClutterParamSpecFixed;
    -GParamSpec *        clutter_param_spec_fixed            (const gchar *name,
    -                                                         const gchar *nick,
    -                                                         const gchar *blurb,
    -                                                         CoglFixed minimum,
    -                                                         CoglFixed maximum,
    -                                                         CoglFixed default_value,
    -                                                         GParamFlags flags);
    -#define             CLUTTER_VALUE_HOLDS_FIXED           (x)
    -void                clutter_value_set_fixed             (GValue *value,
    -                                                         CoglFixed fixed_);
    -CoglFixed           clutter_value_get_fixed             (const GValue *value);
    +GParamSpec *        clutter_param_spec_fixed            (const gchar *name,
    +                                                         const gchar *nick,
    +                                                         const gchar *blurb,
    +                                                         CoglFixed minimum,
    +                                                         CoglFixed maximum,
    +                                                         CoglFixed default_value,
    +                                                         GParamFlags flags);
    +#define             CLUTTER_VALUE_HOLDS_FIXED           (x)
    +void                clutter_value_set_fixed             (GValue *value,
    +                                                         CoglFixed fixed_);
    +CoglFixed           clutter_value_get_fixed             (const GValue *value);
     

    Description

    Various miscellaneous utilility functions.

    +

    +

    Details

    clutter_util_next_p2 ()

    -
    gint                clutter_util_next_p2                (gint a);
    +
    gint                clutter_util_next_p2                (gint a);

    Warning

    clutter_util_next_p2 is deprecated and should not be used in newly-written code. 1.2

    Calculates the nearest power of two, greater than or equal to a.

    +

    +

    @@ -147,22 +218,28 @@

    clutter_timeout_pool_new ()

    -
    ClutterTimeoutPool * clutter_timeout_pool_new           (gint priority);
    +
    ClutterTimeoutPool * clutter_timeout_pool_new           (gint priority);

    Creates a new timeout pool source. A timeout pool should be used when multiple timeout functions, running at the same priority, are needed and -the g_timeout_add() API might lead to starvation of the time slice of +the g_timeout_add() API might lead to starvation of the time slice of the main loop. A timeout pool allocates a single time slice of the main 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.

    +

    +

    @@ -170,7 +247,9 @@ @@ -181,16 +260,26 @@

    clutter_timeout_pool_add ()

    -
    guint               clutter_timeout_pool_add            (ClutterTimeoutPool *pool,
    -                                                         guint fps,
    -                                                         GSourceFunc func,
    -                                                         gpointer data,
    -                                                         GDestroyNotify notify);
    +
    guint               clutter_timeout_pool_add            (ClutterTimeoutPool *pool,
    +                                                         guint fps,
    +                                                         GSourceFunc func,
    +                                                         gpointer data,
    +                                                         GDestroyNotify notify);

    Sets a function to be called at regular intervals, and puts it inside -the pool. The function is repeatedly called until it returns FALSE, +the pool. The function is repeatedly called until it returns FALSE, at which point the timeout is automatically destroyed and the function -won't be called again. If notify is not NULL, the notify function +won't be called again. If notify is not NULL, the notify function will be called. The first call to func will be at the end of interval.

    @@ -202,6 +291,8 @@ 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.

    +

    +

    priority :

    the priority of the timeout pool. Typically this will - be G_PRIORITY_DEFAULT + be G_PRIORITY_DEFAULT
    the newly created ClutterTimeoutPool. The created pool is owned by the GLib default context and will be automatically destroyed when the context is destroyed. It is possible to force - the destruction of the timeout pool using g_source_destroy() + the destruction of the timeout pool using g_source_destroy()
    @@ -222,12 +313,12 @@ - - @@ -244,12 +335,16 @@

    clutter_timeout_pool_remove ()

    -
    void                clutter_timeout_pool_remove         (ClutterTimeoutPool *pool,
    -                                                         guint id);
    +
    void                clutter_timeout_pool_remove         (ClutterTimeoutPool *pool,
    +                                                         guint id);

    Removes a timeout function with id from the timeout pool. The id is the same returned when adding a function to the timeout pool with clutter_timeout_pool_add().

    +

    +

    data :

    data to pass to the function, or NULL + data to pass to the function, or NULL

    notify :

    function to call when the timeout is removed, or NULL + function to call when the timeout is removed, or NULL
    @@ -270,11 +365,21 @@

    clutter_frame_source_add ()

    -
    guint               clutter_frame_source_add            (guint fps,
    -                                                         GSourceFunc func,
    -                                                         gpointer data);
    +
    guint               clutter_frame_source_add            (guint fps,
    +                                                         GSourceFunc func,
    +                                                         gpointer data);

    Simple wrapper around clutter_frame_source_add_full().

    +

    +

    @@ -306,36 +411,54 @@

    clutter_frame_source_add_full ()

    -
    guint               clutter_frame_source_add_full       (gint priority,
    -                                                         guint fps,
    -                                                         GSourceFunc func,
    -                                                         gpointer data,
    -                                                         GDestroyNotify notify);
    +
    guint               clutter_frame_source_add_full       (gint priority,
    +                                                         guint fps,
    +                                                         GSourceFunc func,
    +                                                         gpointer data,
    +                                                         GDestroyNotify notify);

    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 +FALSE, at which point the timeout is automatically destroyed and the function will not be called again. The notify function is called when the timeout is destroyed. The first call to the function will be at the end of the first interval.

    -This function is similar to g_timeout_add_full() except that it +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 +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.

    +

    +

    @@ -378,22 +501,32 @@ } ClutterParamSpecFixed;

    -GParamSpec subclass for fixed point based properties

    +GParamSpec subclass for fixed point based properties

    +

    +

    priority :

    the priority of the frame source. Typically this will be in the - range between G_PRIORITY_DEFAULT and G_PRIORITY_HIGH. + range between G_PRIORITY_DEFAULT and G_PRIORITY_HIGH.
    - + - + - + @@ -404,15 +537,37 @@

    clutter_param_spec_fixed ()

    -
    GParamSpec *        clutter_param_spec_fixed            (const gchar *name,
    -                                                         const gchar *nick,
    -                                                         const gchar *blurb,
    -                                                         CoglFixed minimum,
    -                                                         CoglFixed maximum,
    -                                                         CoglFixed default_value,
    -                                                         GParamFlags flags);
    +
    GParamSpec *        clutter_param_spec_fixed            (const gchar *name,
    +                                                         const gchar *nick,
    +                                                         const gchar *blurb,
    +                                                         CoglFixed minimum,
    +                                                         CoglFixed maximum,
    +                                                         CoglFixed default_value,
    +                                                         GParamFlags flags);
    +

    +Creates a GParamSpec for properties using CoglFixed values

    -Creates a GParamSpec for properties using CoglFixed values

    +

    CoglFixed minimum;

    CoglFixed minimum;

    lower boundary

    CoglFixed maximum;

    CoglFixed maximum;

    higher boundary

    CoglFixed default_value;

    CoglFixed default_value;

    default value
    @@ -453,7 +608,9 @@ - @@ -463,16 +620,22 @@
    -

    CLUTTER_VALUE_HOLDS_FIXED()

    +

    CLUTTER_VALUE_HOLDS_FIXED()

    #define CLUTTER_VALUE_HOLDS_FIXED(x)    (G_VALUE_HOLDS ((x), COGL_TYPE_FIXED))
     

    -Evaluates to TRUE if x holds a CoglFixed .

    +Evaluates to TRUE if x holds a CoglFixed .

    +

    +

    Returns :

    the newly created GParamSpec + the newly created GParamSpec
    -

    x :

    a GValue + a GValue
    @@ -481,16 +644,24 @@

    clutter_value_set_fixed ()

    -
    void                clutter_value_set_fixed             (GValue *value,
    -                                                         CoglFixed fixed_);
    +
    void                clutter_value_set_fixed             (GValue *value,
    +                                                         CoglFixed fixed_);

    Sets value to fixed_.

    +

    +

    - @@ -505,20 +676,30 @@

    clutter_value_get_fixed ()

    -
    CoglFixed           clutter_value_get_fixed             (const GValue *value);
    +
    CoglFixed           clutter_value_get_fixed             (const GValue *value);

    Gets the fixed point value stored inside value.

    +

    +

    value :

    a GValue initialized to COGL_TYPE_FIXED + a GValue initialized to COGL_TYPE_FIXED
    - - @@ -530,6 +711,6 @@ + Generated by GTK-Doc V1.11 - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/html/ClutterContainer.html +++ clutter-1.0-1.2.4/doc/reference/clutter/html/ClutterContainer.html @@ -8,7 +8,7 @@ - + @@ -62,14 +62,14 @@

    value :

    a GValue initialized to COGL_TYPE_FIXED + a GValue initialized to COGL_TYPE_FIXED

    Returns :

    the value inside the passed GValue + the value inside the passed GValue
    Top -  |  - Description -  |  - Object Hierarchy -  |  - Prerequisites -  |  - Known Implementations +  |  + Description +  |  + Object Hierarchy +  |  + Prerequisites +  |  + Known Implementations
    @@ -83,76 +83,109 @@

    Synopsis

    -
                        ClutterContainer;
    +
    +                    ClutterContainer;
                         ClutterContainerIface;
    -void                clutter_container_add_actor         (ClutterContainer *container,
    -                                                         ClutterActor *actor);
    -void                clutter_container_add               (ClutterContainer *container,
    -                                                         ClutterActor *first_actor,
    +void                clutter_container_add_actor         (ClutterContainer *container,
    +                                                         ClutterActor *actor);
    +void                clutter_container_add               (ClutterContainer *container,
    +                                                         ClutterActor *first_actor,
                                                              ...);
    -void                clutter_container_add_valist        (ClutterContainer *container,
    -                                                         ClutterActor *first_actor,
    -                                                         va_list var_args);
    -void                clutter_container_remove_actor      (ClutterContainer *container,
    -                                                         ClutterActor *actor);
    -void                clutter_container_remove            (ClutterContainer *container,
    -                                                         ClutterActor *first_actor,
    +void                clutter_container_add_valist        (ClutterContainer *container,
    +                                                         ClutterActor *first_actor,
    +                                                         va_list var_args);
    +void                clutter_container_remove_actor      (ClutterContainer *container,
    +                                                         ClutterActor *actor);
    +void                clutter_container_remove            (ClutterContainer *container,
    +                                                         ClutterActor *first_actor,
                                                              ...);
    -void                clutter_container_remove_valist     (ClutterContainer *container,
    -                                                         ClutterActor *first_actor,
    -                                                         va_list var_args);
    -GList *             clutter_container_get_children      (ClutterContainer *container);
    -void                clutter_container_foreach           (ClutterContainer *container,
    -                                                         ClutterCallback callback,
    -                                                         gpointer user_data);
    -void                clutter_container_foreach_with_internals
    -                                                        (ClutterContainer *container,
    -                                                         ClutterCallback callback,
    -                                                         gpointer user_data);
    +void                clutter_container_remove_valist     (ClutterContainer *container,
    +                                                         ClutterActor *first_actor,
    +                                                         va_list var_args);
    +GList *             clutter_container_get_children      (ClutterContainer *container);
    +void                clutter_container_foreach           (ClutterContainer *container,
    +                                                         ClutterCallback callback,
    +                                                         gpointer user_data);
    +void                clutter_container_foreach_with_internals
    +                                                        (ClutterContainer *container,
    +                                                         ClutterCallback callback,
    +                                                         gpointer user_data);
     
    -ClutterActor *      clutter_container_find_child_by_name
    -                                                        (ClutterContainer *container,
    -                                                         const gchar *child_name);
    -void                clutter_container_raise_child       (ClutterContainer *container,
    -                                                         ClutterActor *actor,
    -                                                         ClutterActor *sibling);
    -void                clutter_container_lower_child       (ClutterContainer *container,
    -                                                         ClutterActor *actor,
    -                                                         ClutterActor *sibling);
    -void                clutter_container_sort_depth_order  (ClutterContainer *container);
    +ClutterActor *      clutter_container_find_child_by_name
    +                                                        (ClutterContainer *container,
    +                                                         const gchar *child_name);
    +void                clutter_container_raise_child       (ClutterContainer *container,
    +                                                         ClutterActor *actor,
    +                                                         ClutterActor *sibling);
    +void                clutter_container_lower_child       (ClutterContainer *container,
    +                                                         ClutterActor *actor,
    +                                                         ClutterActor *sibling);
    +void                clutter_container_sort_depth_order  (ClutterContainer *container);
     
    -GParamSpec *        clutter_container_class_find_child_property
    -                                                        (GObjectClass *klass,
    -                                                         const gchar *property_name);
    -GParamSpec **       clutter_container_class_list_child_properties
    -                                                        (GObjectClass *klass,
    -                                                         guint *n_properties);
    -void                clutter_container_child_set_property
    -                                                        (ClutterContainer *container,
    -                                                         ClutterActor *child,
    -                                                         const gchar *property,
    -                                                         const GValue *value);
    -void                clutter_container_child_get_property
    -                                                        (ClutterContainer *container,
    -                                                         ClutterActor *child,
    -                                                         const gchar *property,
    -                                                         GValue *value);
    -void                clutter_container_child_set         (ClutterContainer *container,
    -                                                         ClutterActor *actor,
    -                                                         const gchar *first_prop,
    +GParamSpec *        clutter_container_class_find_child_property
    +                                                        (GObjectClass *klass,
    +                                                         const gchar *property_name);
    +GParamSpec **       clutter_container_class_list_child_properties
    +                                                        (GObjectClass *klass,
    +                                                         guint *n_properties);
    +void                clutter_container_child_set_property
    +                                                        (ClutterContainer *container,
    +                                                         ClutterActor *child,
    +                                                         const gchar *property,
    +                                                         const GValue *value);
    +void                clutter_container_child_get_property
    +                                                        (ClutterContainer *container,
    +                                                         ClutterActor *child,
    +                                                         const gchar *property,
    +                                                         GValue *value);
    +void                clutter_container_child_set         (ClutterContainer *container,
    +                                                         ClutterActor *actor,
    +                                                         const gchar *first_prop,
                                                              ...);
    -void                clutter_container_child_get         (ClutterContainer *container,
    -                                                         ClutterActor *actor,
    -                                                         const gchar *first_prop,
    +void                clutter_container_child_get         (ClutterContainer *container,
    +                                                         ClutterActor *actor,
    +                                                         const gchar *first_prop,
                                                              ...);
     
    -void                clutter_container_create_child_meta (ClutterContainer *container,
    -                                                         ClutterActor *actor);
    -void                clutter_container_destroy_child_meta
    -                                                        (ClutterContainer *container,
    -                                                         ClutterActor *actor);
    -ClutterChildMeta *  clutter_container_get_child_meta    (ClutterContainer *container,
    -                                                         ClutterActor *actor);
    +void                clutter_container_create_child_meta (ClutterContainer *container,
    +                                                         ClutterActor *actor);
    +void                clutter_container_destroy_child_meta
    +                                                        (ClutterContainer *container,
    +                                                         ClutterActor *actor);
    +ClutterChildMeta *  clutter_container_get_child_meta    (ClutterContainer *container,
    +                                                         ClutterActor *actor);
     
    @@ -166,7 +199,9 @@

    Prerequisites

    ClutterContainer requires - GObject.

    + GObject.

    Known Implementations

    @@ -186,6 +221,8 @@

    ClutterContainer is available since Clutter 0.4

    +

    +

    Details

    @@ -195,6 +232,8 @@

    ClutterContainer is an opaque structure whose members cannot be directly accessed

    +

    +

    Since 0.4


    @@ -246,29 +285,31 @@ Base interface for container actors. The add, remove and foreach virtual functions must be provided by any implementation; the other virtual functions are optional.

    +

    +

    - + - + - + - + - + - + - + - + - + - + - + - + - + - + @@ -340,13 +383,15 @@

    clutter_container_add_actor ()

    -
    void                clutter_container_add_actor         (ClutterContainer *container,
    -                                                         ClutterActor *actor);
    +
    void                clutter_container_add_actor         (ClutterContainer *container,
    +                                                         ClutterActor *actor);

    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.

    +

    +

    add ()

    add ()

    virtual function for adding an actor to the container. The implementation of this virtual function is required.

    remove ()

    remove ()

    virtual function for removing an actor from the container. The implementation of this virtual function is required.

    foreach ()

    foreach ()

    virtual function for iterating over the container's children. The implementation of this virtual function is required.

    foreach_with_internals ()

    foreach_with_internals ()

    virtual functions for iterating over the container's children, both added using the ClutterContainer API and internal children. The implementation of this virtual function @@ -277,29 +318,31 @@

    raise ()

    raise ()

    virtual function for raising a child

    lower ()

    lower ()

    virtual function for lowering a child

    sort_depth_order ()

    sort_depth_order ()

    virtual function for sorting the children of a container depending on their depth

    GType child_meta_type;

    GType child_meta_type;

    The GType used for storing auxiliary information about each of the containers children.

    create_child_meta ()

    create_child_meta ()

    virtual function that gets called for each added child, the function should instantiate an object of type "child_meta_type", set the container and actor @@ -308,28 +351,28 @@

    destroy_child_meta ()

    destroy_child_meta ()

    virtual function that gets called when a child is removed; it shuld release all resources held by the record

    get_child_meta ()

    get_child_meta ()

    return the record for a container child

    actor_added ()

    actor_added ()

    class handler for "actor_added"

    actor_removed ()

    actor_removed ()

    class handler for "actor_removed"

    child_notify ()

    child_notify ()

    class handler for "child-notify"
    @@ -367,14 +412,16 @@

    clutter_container_add ()

    -
    void                clutter_container_add               (ClutterContainer *container,
    -                                                         ClutterActor *first_actor,
    +
    void                clutter_container_add               (ClutterContainer *container,
    +                                                         ClutterActor *first_actor,
                                                              ...);

    Adds a list of ClutterActors 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.

    +

    +

    @@ -390,7 +437,7 @@ - @@ -400,11 +447,13 @@

    clutter_container_add_valist ()

    -
    void                clutter_container_add_valist        (ClutterContainer *container,
    -                                                         ClutterActor *first_actor,
    -                                                         va_list var_args);
    +
    void                clutter_container_add_valist        (ClutterContainer *container,
    +                                                         ClutterActor *first_actor,
    +                                                         va_list var_args);

    Alternative va_list version of clutter_container_add().

    +

    +

    ... :

    NULL terminated list of actors to add + NULL terminated list of actors to add
    @@ -420,7 +469,7 @@ - @@ -430,13 +479,17 @@

    clutter_container_remove_actor ()

    -
    void                clutter_container_remove_actor      (ClutterContainer *container,
    -                                                         ClutterActor *actor);
    +
    void                clutter_container_remove_actor      (ClutterContainer *container,
    +                                                         ClutterActor *actor);

    Removes actor from container. The actor should be unparented, so if you want to keep it around you must hold a reference to it -yourself, using g_object_ref(). When the actor has been removed, +yourself, using g_object_ref(). When the actor has been removed, the "actor-removed" signal is emitted by container.

    +

    +

    var_args :

    list of actors to add, followed by NULL + list of actors to add, followed by NULL
    @@ -457,15 +510,19 @@

    clutter_container_remove ()

    -
    void                clutter_container_remove            (ClutterContainer *container,
    -                                                         ClutterActor *first_actor,
    +
    void                clutter_container_remove            (ClutterContainer *container,
    +                                                         ClutterActor *first_actor,
                                                              ...);

    -Removes a NULL terminated list of ClutterActors from +Removes a NULL terminated list of ClutterActors from container. Each actor should be unparented, so if you want to keep it -around you must hold a reference to it yourself, using g_object_ref(). +around you must hold a reference to it yourself, using g_object_ref(). Each time an actor is removed, the "actor-removed" signal is emitted by container.

    +

    +

    @@ -481,7 +538,7 @@ - @@ -491,11 +548,13 @@

    clutter_container_remove_valist ()

    -
    void                clutter_container_remove_valist     (ClutterContainer *container,
    -                                                         ClutterActor *first_actor,
    -                                                         va_list var_args);
    +
    void                clutter_container_remove_valist     (ClutterContainer *container,
    +                                                         ClutterActor *first_actor,
    +                                                         va_list var_args);

    Alternative va_list version of clutter_container_remove().

    +

    +

    ... :

    a NULL-terminated list of actors to remove + a NULL-terminated list of actors to remove
    @@ -511,7 +570,7 @@ - @@ -521,9 +580,13 @@

    clutter_container_get_children ()

    -
    GList *             clutter_container_get_children      (ClutterContainer *container);
    +
    GList *             clutter_container_get_children      (ClutterContainer *container);

    Retrieves all the children of container.

    +

    +

    var_args :

    list of actors to remove, followed by NULL + list of actors to remove, followed by NULL
    @@ -534,7 +597,7 @@ - +

    Returns :

    element-type Actor) (transfer container. element-type Actor. transfer container Actor. element-type Actor) (transfer container. element-type Actor. transfer container.
    @@ -543,14 +606,18 @@

    clutter_container_foreach ()

    -
    void                clutter_container_foreach           (ClutterContainer *container,
    -                                                         ClutterCallback callback,
    -                                                         gpointer user_data);
    +
    void                clutter_container_foreach           (ClutterContainer *container,
    +                                                         ClutterCallback callback,
    +                                                         gpointer user_data);

    Calls callback for each child of container that was added by the application (with clutter_container_add_actor()). Does not iterate over "internal" children that are part of the container's own implementation, if any.

    +

    +

    @@ -566,7 +633,7 @@ - @@ -576,14 +643,18 @@

    clutter_container_foreach_with_internals ()

    -
    void                clutter_container_foreach_with_internals
    -                                                        (ClutterContainer *container,
    -                                                         ClutterCallback callback,
    -                                                         gpointer user_data);
    +
    void                clutter_container_foreach_with_internals
    +                                                        (ClutterContainer *container,
    +                                                         ClutterCallback callback,
    +                                                         gpointer user_data);

    Calls callback for each child of container, including "internal" children built in to the container itself that were never added by the application.

    +

    +

    user_data :

    data to be passed to the function, or NULL + data to be passed to the function, or NULL
    @@ -599,7 +670,7 @@ - @@ -609,12 +680,16 @@

    clutter_container_find_child_by_name ()

    -
    ClutterActor *      clutter_container_find_child_by_name
    -                                                        (ClutterContainer *container,
    -                                                         const gchar *child_name);
    +
    ClutterActor *      clutter_container_find_child_by_name
    +                                                        (ClutterContainer *container,
    +                                                         const gchar *child_name);

    Finds a child actor of a container by its name. Search recurses into any child container.

    +

    +

    user_data :

    data to be passed to the function, or NULL + data to be passed to the function, or NULL
    @@ -630,7 +705,7 @@ - +

    Returns :

    transfer none. transfer none. transfer none. transfer none.
    @@ -639,11 +714,13 @@

    clutter_container_raise_child ()

    -
    void                clutter_container_raise_child       (ClutterContainer *container,
    -                                                         ClutterActor *actor,
    -                                                         ClutterActor *sibling);
    +
    void                clutter_container_raise_child       (ClutterContainer *container,
    +                                                         ClutterActor *actor,
    +                                                         ClutterActor *sibling);

    Raises actor to sibling level, in the depth ordering.

    +

    +

    @@ -659,7 +736,7 @@ - @@ -669,11 +746,13 @@

    clutter_container_lower_child ()

    -
    void                clutter_container_lower_child       (ClutterContainer *container,
    -                                                         ClutterActor *actor,
    -                                                         ClutterActor *sibling);
    +
    void                clutter_container_lower_child       (ClutterContainer *container,
    +                                                         ClutterActor *actor,
    +                                                         ClutterActor *sibling);

    Lowers actor to sibling level, in the depth ordering.

    +

    +

    sibling :

    the sibling to raise to, or NULL to raise to the top + the sibling to raise to, or NULL to raise to the top
    @@ -689,7 +768,7 @@ - @@ -699,10 +778,12 @@

    clutter_container_sort_depth_order ()

    -
    void                clutter_container_sort_depth_order  (ClutterContainer *container);
    +
    void                clutter_container_sort_depth_order  (ClutterContainer *container);

    Sorts a container's children using their depth. This function should not be normally used by applications.

    +

    +

    sibling :

    the sibling to lower to, or NULL to lower to the bottom + the sibling to lower to, or NULL to lower to the bottom
    @@ -716,17 +797,29 @@

    clutter_container_class_find_child_property ()

    -
    GParamSpec *        clutter_container_class_find_child_property
    -                                                        (GObjectClass *klass,
    -                                                         const gchar *property_name);
    +
    GParamSpec *        clutter_container_class_find_child_property
    +                                                        (GObjectClass *klass,
    +                                                         const gchar *property_name);
    +

    +Looks up the GParamSpec for a child property of klass.

    -Looks up the GParamSpec for a child property of klass.

    +

    - @@ -736,7 +829,7 @@ - +

    klass :

    a GObjectClass implementing the ClutterContainer interface. + a GObjectClass implementing the ClutterContainer interface.

    Returns :

    transfer none. transfer none. transfer none. transfer none.
    @@ -745,17 +838,29 @@

    clutter_container_class_list_child_properties ()

    -
    GParamSpec **       clutter_container_class_list_child_properties
    -                                                        (GObjectClass *klass,
    -                                                         guint *n_properties);
    +
    GParamSpec **       clutter_container_class_list_child_properties
    +                                                        (GObjectClass *klass,
    +                                                         guint *n_properties);
    +

    +Returns an array of GParamSpec for all child properties.

    -Returns an array of GParamSpec for all child properties.

    +

    - @@ -765,7 +870,7 @@ - +

    klass :

    a GObjectClass implementing the ClutterContainer interface. + a GObjectClass implementing the ClutterContainer interface.

    Returns :

    array length=n_properties) (transfer container. array length=n_properties. transfer container length=n_properties. array length=n_properties) (transfer container. array length=n_properties. transfer container.
    @@ -774,13 +879,19 @@

    clutter_container_child_set_property ()

    -
    void                clutter_container_child_set_property
    -                                                        (ClutterContainer *container,
    -                                                         ClutterActor *child,
    -                                                         const gchar *property,
    -                                                         const GValue *value);
    +
    void                clutter_container_child_set_property
    +                                                        (ClutterContainer *container,
    +                                                         ClutterActor *child,
    +                                                         const gchar *property,
    +                                                         const GValue *value);

    Sets a container-specific property on a child of container.

    +

    +

    @@ -811,20 +922,28 @@

    clutter_container_child_get_property ()

    -
    void                clutter_container_child_get_property
    -                                                        (ClutterContainer *container,
    -                                                         ClutterActor *child,
    -                                                         const gchar *property,
    -                                                         GValue *value);
    +
    void                clutter_container_child_get_property
    +                                                        (ClutterContainer *container,
    +                                                         ClutterActor *child,
    +                                                         const gchar *property,
    +                                                         GValue *value);

    Gets a container specific property of a child of container, In general, a copy is made of the property contents and the caller is responsible for -freeing the memory by calling g_value_unset(). +freeing the memory by calling g_value_unset().

    Note that clutter_container_child_set_property() is really intended for language bindings, clutter_container_child_set() is much more convenient for C programming.

    +

    +

    @@ -855,12 +974,16 @@

    clutter_container_child_set ()

    -
    void                clutter_container_child_set         (ClutterContainer *container,
    -                                                         ClutterActor *actor,
    -                                                         const gchar *first_prop,
    +
    void                clutter_container_child_set         (ClutterContainer *container,
    +                                                         ClutterActor *actor,
    +                                                         const gchar *first_prop,
                                                              ...);

    Sets container specific properties on the child of a container.

    +

    +

    @@ -892,9 +1015,11 @@

    clutter_container_child_get ()

    -
    void                clutter_container_child_get         (ClutterContainer *container,
    -                                                         ClutterActor *actor,
    -                                                         const gchar *first_prop,
    +
    void                clutter_container_child_get         (ClutterContainer *container,
    +                                                         ClutterActor *actor,
    +                                                         const gchar *first_prop,
                                                              ...);

    Gets container specific properties of an actor. @@ -902,7 +1027,13 @@

    In general, a copy is made of the property contents and the caller is responsible for freeing the memory in the appropriate manner for the type, for -instance by calling g_free() or g_object_unref().

    +instance by calling g_free() or g_object_unref().

    +

    +

    @@ -934,20 +1065,22 @@

    clutter_container_create_child_meta ()

    -
    void                clutter_container_create_child_meta (ClutterContainer *container,
    -                                                         ClutterActor *actor);
    +
    void                clutter_container_create_child_meta (ClutterContainer *container,
    +                                                         ClutterActor *actor);

    Creates the ClutterChildMeta wrapping actor inside the container, if the "child_meta_type" -class member is not set to G_TYPE_INVALID. +class member is not set to G_TYPE_INVALID.

    This function is only useful when adding a ClutterActor to a ClutterContainer implementation outside of the -ClutterContainer::add() virtual function implementation. +""add() virtual function implementation.

    Applications should not call this function.

    +

    +

    @@ -968,9 +1101,9 @@

    clutter_container_destroy_child_meta ()

    -
    void                clutter_container_destroy_child_meta
    -                                                        (ClutterContainer *container,
    -                                                         ClutterActor *actor);
    +
    void                clutter_container_destroy_child_meta
    +                                                        (ClutterContainer *container,
    +                                                         ClutterActor *actor);

    Destroys the ClutterChildMeta wrapping actor inside the container, if any. @@ -978,10 +1111,12 @@

    This function is only useful when removing a ClutterActor to a ClutterContainer implementation outside of the -ClutterContainer::add() virtual function implementation. +""add() virtual function implementation.

    Applications should not call this function.

    +

    +

    @@ -1002,11 +1137,13 @@

    clutter_container_get_child_meta ()

    -
    ClutterChildMeta *  clutter_container_get_child_meta    (ClutterContainer *container,
    -                                                         ClutterActor *actor);
    +
    ClutterChildMeta *  clutter_container_get_child_meta    (ClutterContainer *container,
    +                                                         ClutterActor *actor);

    Retrieves the ClutterChildMeta which contains the data about the container specific state for actor.

    +

    +

    @@ -1022,7 +1159,7 @@ - +

    Returns :

    transfer none. transfer none. transfer none. transfer none.
    @@ -1032,6 +1169,6 @@
    + Generated by GTK-Doc V1.11
    - \ No newline at end of file + --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-stage-manager.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-stage-manager.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-actor.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-actor.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-box.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-box.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-behaviour-rotate.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-behaviour-rotate.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-script.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-script.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-util.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-util.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-event.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-event.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-behaviour-path.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-behaviour-path.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-group.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-group.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-behaviour-depth.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-behaviour-depth.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-alpha.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-alpha.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-win32.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-win32.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-animation.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-animation.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-layout-manager.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-layout-manager.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-color.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-color.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-timeline.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-timeline.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-feature.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-feature.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-animatable.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-animatable.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-shader.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-shader.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-interval.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-interval.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-eglnative.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-eglnative.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-behaviour.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-behaviour.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-behaviour-ellipse.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-behaviour-ellipse.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-score.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-score.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-clone.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-clone.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-model-iter.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-model-iter.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-version.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-version.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-x11.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-x11.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-path.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-path.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-eglx.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-eglx.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-model.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-model.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-binding-pool.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-binding-pool.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-rectangle.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-rectangle.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-flow-layout.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-flow-layout.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-behaviour-scale.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-behaviour-scale.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-fixed-layout.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-fixed-layout.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-list-model.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-list-model.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-media.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-media.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-glx.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-glx.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-texture.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-texture.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-backend.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-backend.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-child-meta.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-child-meta.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-main.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-main.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-stage.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-stage.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-bin-layout.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-bin-layout.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-cairo-texture.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-cairo-texture.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-scriptable.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-scriptable.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-input-device.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-input-device.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-container.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-container.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-text.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-text.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-device-manager.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-device-manager.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-units.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-units.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-box-layout.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-box-layout.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-animator.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-animator.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-behaviour-opacity.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-behaviour-opacity.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/doc/reference/clutter/tmpl/clutter-layout-meta.sgml +++ clutter-1.0-1.2.4/doc/reference/clutter/tmpl/clutter-layout-meta.sgml @@ -9,13 +9,11 @@ - - --- clutter-1.0-1.2.4.orig/debian/libclutter-1.0-0.install +++ clutter-1.0-1.2.4/debian/libclutter-1.0-0.install @@ -0,0 +1 @@ +debian/tmp/usr/lib/*.so.* --- clutter-1.0-1.2.4.orig/debian/libclutter-1.0-doc.links +++ clutter-1.0-1.2.4/debian/libclutter-1.0-doc.links @@ -0,0 +1,2 @@ +usr/share/gtk-doc/html/clutter usr/share/doc/libclutter-doc/html +usr/share/gtk-doc/html/cogl usr/share/doc/libclutter-doc/html-cogl --- clutter-1.0-1.2.4.orig/debian/libclutter-1.0-dev.examples +++ clutter-1.0-1.2.4/debian/libclutter-1.0-dev.examples @@ -0,0 +1,2 @@ +tests/*.c +tests/*.png --- clutter-1.0-1.2.4.orig/debian/control.in +++ clutter-1.0-1.2.4/debian/control.in @@ -0,0 +1,91 @@ +Source: clutter-1.0 +Section: libs +Priority: optional +Maintainer: Ubuntu Developers +XSBC-Original-Maintainer: Ross Burton +Uploaders: @GNOME_TEAM@ +Build-Depends: debhelper (>= 5), + cdbs (>= 0.4.41), + gnome-pkg-tools, + libgl1-mesa-dev | libgl-dev, + libgtk2.0-dev, + libcairo2-dev (>= 1.4), + libpango1.0-dev (>= 1.20), + libglib2.0-dev (>= 2.16), + gtk-doc-tools, + libgirepository1.0-dev (>= 0.6.3), + gobject-introspection (>= 0.6.5-3), + gir1.0-freedesktop (>= 0.6.3), + gir1.0-glib-2.0, + gir1.0-gtk-2.0, + gir-repository-dev +Standards-Version: 3.8.3 + +Package: libclutter-1.0-0 +Section: libs +Architecture: any +Depends: ${shlibs:Depends}, + ${misc:Depends} +Description: Open GL based interactive canvas library + Clutter is an Open GL based interactive canvas library, designed for creating + fast, mainly 2D single window applications such as media box UIs, + presentations, kiosk style applications and so on. + +Package: libclutter-1.0-dev +Section: libdevel +Architecture: any +Depends: libclutter-1.0-0 (= ${binary:Version}), + libgtk2.0-dev, + libgl1-mesa-dev|libgl-dev, + ${misc:Depends}, + ${shlibs:Depends} +Recommends: pkg-config +Suggests: libclutter-1.0-doc +Description: Open GL based interactive canvas library (development files) + Clutter is an Open GL based interactive canvas library, designed for creating + fast, mainly 2D single window applications such as media box UIs, + presentations, kiosk style applications and so on. + . + This package contains the development files. + +Package: libclutter-1.0-dbg +Section: debug +Priority: extra +Architecture: any +Depends: libclutter-1.0-0 (= ${binary:Version}), + ${misc:Depends} +Description: Open GL based interactive canvas library (debug files) + Clutter is an Open GL based interactive canvas library, designed for creating + fast, mainly 2D single window applications such as media box UIs, + presentations, kiosk style applications and so on. + . + This package contains the debug files. + +Package: libclutter-1.0-doc +Section: doc +Architecture: all +Depends: ${misc:Depends} +Suggests: devhelp +Conflicts: libclutter-0.1-doc, libclutter-doc +Replaces: libclutter-0.1-doc +Description: Open GL based interactive canvas library (documentation) + Clutter is an Open GL based interactive canvas library, designed for creating + fast, mainly 2D single window applications such as media box UIs, + presentations, kiosk style applications and so on. + . + This package contains the documentation. + +Package: gir1.0-clutter-1.0 +Section: libs +Architecture: any +Depends: ${gir:Depends}, + ${shlibs:Depends}, + ${misc:Depends} +Conflicts: libclutter-1.0-0 (<< 1.0.8) +Replaces: libclutter-1.0-0 (<< 1.0.8) +Description: GObject introspection data for the Clutter 1.0 library + This package contains introspection data for the Clutter scene + graph library. + . + It can be used by packages using the GIRepository format to generate + dynamic bindings. --- clutter-1.0-1.2.4.orig/debian/watch +++ clutter-1.0-1.2.4/debian/watch @@ -0,0 +1,2 @@ +version=2 +http://www.clutter-project.org/sources/clutter/([\d.]+[02468])/clutter-(.*)\.tar\.gz --- clutter-1.0-1.2.4.orig/debian/rules +++ clutter-1.0-1.2.4/debian/rules @@ -0,0 +1,26 @@ +#!/usr/bin/make -f + +include /usr/share/cdbs/1/rules/debhelper.mk +include /usr/share/cdbs/1/class/gnome.mk +include /usr/share/cdbs/1/rules/simple-patchsys.mk +include /usr/share/cdbs/1/rules/utils.mk +include /usr/share/gnome-pkg-tools/1/rules/uploaders.mk +-include /usr/share/gnome-pkg-tools/1/rules/gnome-get-source.mk + +GNOME_MODULE = clutter +GNOME_DOWNLOAD_URL = http://www.clutter-project.org/sources/clutter/$(DEB_UPSTREAM_VERSION_MAJOR_MINOR)/$(GNOME_TARBALL) + +LDFLAGS += -Wl,-O1 -Wl,--as-needed +DEB_COMPRESS_EXCLUDE += .c +DEB_CONFIGURE_EXTRA_FLAGS += --enable-gtk-doc \ + --enable-introspection=yes + +#CPU := $(shell dpkg-architecture -qDEB_HOST_ARCH_CPU) +#ifeq ($(CPU),arm) +#CFLAGS += -march=armv5t +#endif + +$(patsubst %,binary-predeb/%,$(DEB_ALL_PACKAGES)) :: + dh_girepository -p$(cdbs_curpkg) + +common-binary-predeb-arch:: list-missing --- clutter-1.0-1.2.4.orig/debian/libclutter-1.0-dev.install +++ clutter-1.0-1.2.4/debian/libclutter-1.0-dev.install @@ -0,0 +1,4 @@ +debian/tmp/usr/lib/*.so +debian/tmp/usr/lib/pkgconfig/ +debian/tmp/usr/include/ +debian/tmp/usr/share/gir-1.0/ --- clutter-1.0-1.2.4.orig/debian/control +++ clutter-1.0-1.2.4/debian/control @@ -0,0 +1,96 @@ +# This file is autogenerated. DO NOT EDIT! +# +# Modifications should be made to debian/control.in instead. +# This file is regenerated automatically in the clean target. + +Source: clutter-1.0 +Section: libs +Priority: optional +Maintainer: Ubuntu Developers +XSBC-Original-Maintainer: Ross Burton +Uploaders: Debian GNOME Maintainers , Emilio Pozuelo Monfort , Gustavo Noronha Silva , Rob Bradford , Ross Burton +Build-Depends: debhelper (>= 5), + cdbs (>= 0.4.41), + gnome-pkg-tools, + libgl1-mesa-dev | libgl-dev, + libgtk2.0-dev, + libcairo2-dev (>= 1.4), + libpango1.0-dev (>= 1.20), + libglib2.0-dev (>= 2.16), + gtk-doc-tools, + libgirepository1.0-dev (>= 0.6.3), + gobject-introspection (>= 0.6.5-3), + gir1.0-freedesktop (>= 0.6.3), + gir1.0-glib-2.0, + gir1.0-gtk-2.0, + gir-repository-dev +Standards-Version: 3.8.3 + +Package: libclutter-1.0-0 +Section: libs +Architecture: any +Depends: ${shlibs:Depends}, + ${misc:Depends} +Description: Open GL based interactive canvas library + Clutter is an Open GL based interactive canvas library, designed for creating + fast, mainly 2D single window applications such as media box UIs, + presentations, kiosk style applications and so on. + +Package: libclutter-1.0-dev +Section: libdevel +Architecture: any +Depends: libclutter-1.0-0 (= ${binary:Version}), + libgtk2.0-dev, + libgl1-mesa-dev|libgl-dev, + ${misc:Depends}, + ${shlibs:Depends} +Recommends: pkg-config +Suggests: libclutter-1.0-doc +Description: Open GL based interactive canvas library (development files) + Clutter is an Open GL based interactive canvas library, designed for creating + fast, mainly 2D single window applications such as media box UIs, + presentations, kiosk style applications and so on. + . + This package contains the development files. + +Package: libclutter-1.0-dbg +Section: debug +Priority: extra +Architecture: any +Depends: libclutter-1.0-0 (= ${binary:Version}), + ${misc:Depends} +Description: Open GL based interactive canvas library (debug files) + Clutter is an Open GL based interactive canvas library, designed for creating + fast, mainly 2D single window applications such as media box UIs, + presentations, kiosk style applications and so on. + . + This package contains the debug files. + +Package: libclutter-1.0-doc +Section: doc +Architecture: all +Depends: ${misc:Depends} +Suggests: devhelp +Conflicts: libclutter-0.1-doc, libclutter-doc +Replaces: libclutter-0.1-doc +Description: Open GL based interactive canvas library (documentation) + Clutter is an Open GL based interactive canvas library, designed for creating + fast, mainly 2D single window applications such as media box UIs, + presentations, kiosk style applications and so on. + . + This package contains the documentation. + +Package: gir1.0-clutter-1.0 +Section: libs +Architecture: any +Depends: ${gir:Depends}, + ${shlibs:Depends}, + ${misc:Depends} +Conflicts: libclutter-1.0-0 (<< 1.0.8) +Replaces: libclutter-1.0-0 (<< 1.0.8) +Description: GObject introspection data for the Clutter 1.0 library + This package contains introspection data for the Clutter scene + graph library. + . + It can be used by packages using the GIRepository format to generate + dynamic bindings. --- clutter-1.0-1.2.4.orig/debian/libclutter-1.0-doc.install +++ clutter-1.0-1.2.4/debian/libclutter-1.0-doc.install @@ -0,0 +1,2 @@ +debian/tmp/usr/share/gtk-doc/html/cogl +debian/tmp/usr/share/gtk-doc/html/clutter --- clutter-1.0-1.2.4.orig/debian/changelog +++ clutter-1.0-1.2.4/debian/changelog @@ -0,0 +1,223 @@ +clutter-1.0 (1.2.4-0ubuntu1) lucid; urgency=low + + * New upstream release: + - Revert patch for bug 2017 which broke subclassing ClutterListModel + - Add more error reporting in case the GLX context creation failed + - Fix cogl_texture_get_data() returning garbage + - Fix the computation of the stage bounding rectangle when submitting + clipped redraw requests + - Switch texture units before setting the Cogl texture filters + - Make sure that GLX_SGI_swap_control is set up correctly + * debian/patches/01_fix_motion_events.patch: + - Set a default stage for motion events if one isn't available + (Neil J. Patel) + + -- Didier Roche Thu, 25 Mar 2010 14:16:07 +0100 + +clutter-1.0 (1.2.2-1ubuntu1) lucid; urgency=low + + * Merge from debian experimental, remaining changes: + - comment out the enforced building for armv5t in debian/rules, ubuntu + does not support v5t anymore (fixes FTBFS on armel). + * don't build with json support (will mean deps update): + - debian/rules: remove --enable-json + - debian/control.in: remove libjson-glib-dev (>= 0.8) and + gir1.0-json-glib-1.0 build-dep + + -- Didier Roche Tue, 23 Mar 2010 20:19:50 +0100 + +clutter-1.0 (1.2.2-1) experimental; urgency=low + + [ Gustavo Noronha Silva ] + * debian/control: + - bump Standards-Version to 3.8.3 + + [ Emilio Pozuelo Monfort ] + * New upstream release. + - Build depend on libjson-glib-dev and gir1.0-json-glib-1.0. + * debian/control.in, + debian/rules: + - GNOMEify. + + -- Emilio Pozuelo Monfort Sun, 21 Mar 2010 13:27:56 +0100 + +clutter-1.0 (1.0.8-1) unstable; urgency=low + + * New upstream release + * debian/control: + - adopt new GObject-Introspection mini-policy, by build-depending on + gobject-introspection >= 0.6.5-3, and using the new gir1.0-* packages + * debian/control, libclutter-1.0-0.install, gir1.0-clutter-1.0.install: + - add new package for the typelib files + * debian/rules: + - make dh_girepository be called on the packages + + -- Gustavo Noronha Silva Mon, 19 Oct 2009 13:55:06 -0200 + +clutter-1.0 (1.0.6-1) unstable; urgency=low + + * New upstream release + + -- Gustavo Noronha Silva Wed, 30 Sep 2009 19:25:03 +0100 + +clutter-1.0 (1.0.0-1) unstable; urgency=low + + [ Loïc Minier ] + * Downgrade pkg-config dep to a recommends. + * Update download URL in copyright. + * Use LDFLAGS/CFLAGS vars directly to avoid overriding them completely; bdep + on cdbs >= 0.4.41. + * Wrap build-deps and deps. + * Let libclutter-0.8-dev dep on ${shlibs:Depends}. + * Bdep on libpango1.0-dev (>= 1.18) and libglib2.0-dev (>= 2.14) + explicitly. + * Cleanup rules. + * Use CDBS gnome.mk class instead of autotools. + + [ Gustavo Noronha Silva ] + * New stable upstream release + * Updated build-dependencies according to upstream's configure.ac + * Build-Depend on cairo explicitly + * debian/control: + - make the doc package clutter-version-specific (libclutter-1.0-doc), + and make it conflict with libclutter-doc + * debian/copyright: + - fixed and updated information with recent copyright changes + + -- Gustavo Noronha Silva Thu, 30 Jul 2009 12:48:00 +0200 + +clutter (0.8.8-1) unstable; urgency=low + + * New upstream release. + * Ship the COGL documentation + * Clean up minor lintian warnings + + -- Ross Burton Fri, 19 Jun 2009 11:38:03 +0100 + +clutter (0.8.4-1) unstable; urgency=low + + * New upstream release + - Fixes linking (Closes: #498506) + + -- Ross Burton Mon, 01 Dec 2008 14:46:24 +0000 + +clutter (0.8.2-1) unstable; urgency=low + + * New upstream release. + + -- Rob Bradford Fri, 26 Sep 2008 16:09:31 +0100 + +clutter (0.8.0-1) unstable; urgency=low + + * New upstream release. + + -- Rob Bradford Sat, 12 Jul 2008 21:34:06 +0100 + +clutter (0.6.4-1) unstable; urgency=low + + * New upstream release. + + -- Rob Bradford Sun, 29 Jun 2008 21:30:53 +0100 + +clutter (0.6.2-2) unstable; urgency=low + + * Switch to using -march=armv5t when compiling on ARM (closes: #478152.) + + -- Rob Bradford Mon, 19 May 2008 15:30:29 +0100 + +clutter (0.6.2-1) unstable; urgency=low + + * New upstream release. + + -- Rob Bradford Thu, 03 Apr 2008 15:08:09 +0100 + +clutter (0.6.0-2) unstable; urgency=low + + * Switch dependency to libgl1-mesa-dev|libgl-dev rather than + just libgl1-mesa-dev so that it does not conflict with other installed + OpenGL headers. + + -- Rob Bradford Thu, 28 Feb 2008 14:54:24 +0000 + +clutter (0.6.0-1) unstable; urgency=low + + * New upstream release. + - Replace deprecated substvars. + - Update debian/copyright file. + + -- Rob Bradford Mon, 18 Feb 2008 13:27:15 +0000 + +clutter (0.5.6-1) unstable; urgency=low + + * New (unstable) upstream release. + + -- Rob Bradford Mon, 11 Feb 2008 17:21:32 +0000 + +clutter (0.5.2-1) unstable; urgency=low + + * New (unstable) upstream release. + + -- Rob Bradford Mon, 14 Jan 2008 13:34:58 +0000 + +clutter (0.5.0-1) unstable; urgency=low + + * New (unstable) upstream release. + + -- Rob Bradford Thu, 10 Jan 2008 15:58:27 +0000 + +clutter (0.4.2-1) unstable; urgency=low + + * New upstream release. + + -- Ross Burton Tue, 18 Sep 2007 11:30:38 +0100 + +clutter (0.4.1-1) unstable; urgency=low + + * New upstream release. + + -- Ross Burton Mon, 20 Aug 2007 13:55:10 +0100 + +clutter (0.4.0-1) unstable; urgency=low + + * New upstream release. + + -- Ross Burton Tue, 7 Aug 2007 20:50:46 +0100 + +clutter (0.3.1-1) unstable; urgency=low + + * New upstream release. + + -- Ross Burton Tue, 24 Jul 2007 09:13:14 +0100 + +clutter (0.2.3-1) unstable; urgency=low + + * New upstream release. + + -- Ross Burton Wed, 11 Apr 2007 18:37:12 +0100 + +clutter (0.2.2-1) unstable; urgency=low + + * New upstream release. + * Don't compress the examples. + + -- Ross Burton Wed, 14 Feb 2007 09:26:01 +0000 + +clutter (0.2.1-1) unstable; urgency=low + + * New upstream release. + - Upstream package split up, remove Python packaging + + -- Ross Burton Wed, 7 Feb 2007 16:18:44 +0000 + +clutter (0.1.0-2) unstable; urgency=low + + * Ship the Python bindings in python2.4-clutter (thanks to Jeff Waugh) + + -- Ross Burton Fri, 23 Jun 2006 11:48:12 +0100 + +clutter (0.1.0-1) unstable; urgency=low + + * Initial upload. + + -- Ross Burton Wed, 21 Jun 2006 17:46:05 +0100 + --- clutter-1.0-1.2.4.orig/debian/copyright +++ clutter-1.0-1.2.4/debian/copyright @@ -0,0 +1,31 @@ +This package was debianized by Ross Burton on Wed, 21 Jun 2006 +17:40:36 +0100. + +It was downloaded from http://www.clutter-project.org/sources/clutter/ + +Upstream Authors: +Matthew Allum +Emmanuele Bassi +Iain Holmes +Jorn Baayen + +Copyright (C) 2006-2008 OpenedHand Ltd. +Copyright (C) 2009 Intel Corp. + +License: + + This library is free software; you can redistribute it and/or modify it under + the terms of the GNU Lesser General Public License as published by the Free + Software Foundation; either version 2 of the License, or (at your option) any + later version. + + This library is distributed in the hope that it will be useful, but WITHOUT + ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS + FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. + + You should have received a copy of the GNU Lesser General Public License along + with this library; if not, write to the Free Software Foundation, Inc., 51 + Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. + +On Debian systems, the complete text of the GNU General +Public License can be found in `/usr/share/common-licenses/LGPL-2'. --- clutter-1.0-1.2.4.orig/debian/compat +++ clutter-1.0-1.2.4/debian/compat @@ -0,0 +1 @@ +5 --- clutter-1.0-1.2.4.orig/debian/gir1.0-clutter-1.0.install +++ clutter-1.0-1.2.4/debian/gir1.0-clutter-1.0.install @@ -0,0 +1 @@ +debian/tmp/usr/lib/girepository-1.0/ --- clutter-1.0-1.2.4.orig/debian/patches/01_fix_motion_events.patch +++ clutter-1.0-1.2.4/debian/patches/01_fix_motion_events.patch @@ -0,0 +1,13 @@ +diff -Nur -x '*.orig' -x '*~' clutter-1.0-1.2.4/clutter/x11/clutter-event-x11.c clutter-1.0-1.2.4.new/clutter/x11/clutter-event-x11.c +--- clutter-1.0-1.2.4/clutter/x11/clutter-event-x11.c 2010-03-18 18:18:06.000000000 +0100 ++++ clutter-1.0-1.2.4.new/clutter/x11/clutter-event-x11.c 2010-03-25 14:00:40.468681377 +0100 +@@ -778,6 +778,9 @@ + break; + + case MotionNotify: ++ if (device->stage == NULL) ++ _clutter_input_device_set_stage (device, stage); ++ + event->motion.type = event->type = CLUTTER_MOTION; + event->motion.time = xevent->xmotion.time; + event->motion.x = xevent->xmotion.x;