[goocanvas/introspection] Add some more annotations



commit 6cca1c8a1888cfe76367e87672931acae83a87be
Author: Tristan Brindle <tristan fugro-fsi com au>
Date:   Tue May 24 18:18:00 2011 +0800

    Add some more annotations

 src/goocanvas.c     |   16 ++++++++--------
 src/goocanvasitem.c |    8 ++++----
 2 files changed, 12 insertions(+), 12 deletions(-)
---
diff --git a/src/goocanvas.c b/src/goocanvas.c
index 986fd20..8c8c401 100644
--- a/src/goocanvas.c
+++ b/src/goocanvas.c
@@ -3597,8 +3597,8 @@ goo_canvas_keyboard_ungrab (GooCanvas     *canvas,
 /**
  * goo_canvas_convert_to_pixels:
  * @canvas: a #GooCanvas.
- * @x: a pointer to the x coordinate to convert.
- * @y: a pointer to the y coordinate to convert.
+ * @x: (inout): a pointer to the x coordinate to convert.
+ * @y: (inout): a pointer to the y coordinate to convert.
  *
  * Converts a coordinate from the canvas coordinate space to pixels.
  *
@@ -3622,8 +3622,8 @@ goo_canvas_convert_to_pixels (GooCanvas     *canvas,
 /**
  * goo_canvas_convert_from_pixels:
  * @canvas: a #GooCanvas.
- * @x: a pointer to the x coordinate to convert.
- * @y: a pointer to the y coordinate to convert.
+ * @x: (inout): a pointer to the x coordinate to convert.
+ * @y: (inout): a pointer to the y coordinate to convert.
  *
  * Converts a coordinate from pixels to the canvas coordinate space.
  *
@@ -3711,8 +3711,8 @@ get_transform_to_item_space (GooCanvasItem  *item,
  * goo_canvas_convert_to_item_space:
  * @canvas: a #GooCanvas.
  * @item: a #GooCanvasItem.
- * @x: a pointer to the x coordinate to convert.
- * @y: a pointer to the y coordinate to convert.
+ * @x: (inout): a pointer to the x coordinate to convert.
+ * @y: (inout): a pointer to the y coordinate to convert.
  *
  * Converts a coordinate from the canvas coordinate space to the given
  * item's coordinate space, applying all transformation matrices including the
@@ -3735,8 +3735,8 @@ goo_canvas_convert_to_item_space (GooCanvas     *canvas,
  * goo_canvas_convert_from_item_space:
  * @canvas: a #GooCanvas.
  * @item: a #GooCanvasItem.
- * @x: a pointer to the x coordinate to convert.
- * @y: a pointer to the y coordinate to convert.
+ * @x: (inout): a pointer to the x coordinate to convert.
+ * @y: (inout): a pointer to the y coordinate to convert.
  *
  * Converts a coordinate from the given item's coordinate space to the canvas
  * coordinate space, applying all transformation matrices including the
diff --git a/src/goocanvasitem.c b/src/goocanvasitem.c
index 07ff65d..6daf065 100644
--- a/src/goocanvasitem.c
+++ b/src/goocanvasitem.c
@@ -923,11 +923,11 @@ goo_canvas_item_lower          (GooCanvasItem *item,
 /**
  * goo_canvas_item_get_transform:
  * @item: an item.
- * @transform: the place to store the transform.
+ * @transform: (out callee-allocates) (transfer none) (allow-none): the place to store the transform.
  * 
  * Gets the transformation matrix of an item.
  * 
- * Returns: %TRUE if a transform is set.
+ * Returns: (skip): %TRUE if a transform is set.
  **/
 gboolean
 goo_canvas_item_get_transform  (GooCanvasItem   *item,
@@ -972,7 +972,7 @@ goo_canvas_item_get_transform_for_child  (GooCanvasItem  *item,
 /**
  * goo_canvas_item_set_transform:
  * @item: an item.
- * @transform: the new transformation matrix, or %NULL to reset the
+ * @transform: (allow-none): the new transformation matrix, or %NULL to reset the
  *  transformation to the identity matrix.
  * 
  * Sets the transformation matrix of an item.
@@ -1521,7 +1521,7 @@ goo_canvas_item_request_update  (GooCanvasItem *item)
 /**
  * goo_canvas_item_get_bounds:
  * @item: a #GooCanvasItem.
- * @bounds: a #GooCanvasBounds to return the bounds in.
+ * @bounds: (out): a #GooCanvasBounds to return the bounds in.
  * 
  * Gets the bounds of the item.
  *



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]