[gimp] gir: Mark more (out) annotations
- From: Niels De Graef <nielsdg src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gimp] gir: Mark more (out) annotations
- Date: Fri, 8 May 2020 15:11:39 +0000 (UTC)
commit 4b6362c0bdff41245b5461f1534649b23ffb6503
Author: Niels De Graef <nielsdegraef gmail com>
Date: Fri May 8 17:11:14 2020 +0200
gir: Mark more (out) annotations
libgimpwidgets/gimpintcombobox.c | 2 +-
libgimpwidgets/gimppageselector.c | 6 +++---
libgimpwidgets/gimppreview.c | 24 +++++++++++++++++++-----
3 files changed, 23 insertions(+), 9 deletions(-)
---
diff --git a/libgimpwidgets/gimpintcombobox.c b/libgimpwidgets/gimpintcombobox.c
index c300d751d1..d865ef2170 100644
--- a/libgimpwidgets/gimpintcombobox.c
+++ b/libgimpwidgets/gimpintcombobox.c
@@ -463,7 +463,7 @@ gimp_int_combo_box_set_active (GimpIntComboBox *combo_box,
/**
* gimp_int_combo_box_get_active:
* @combo_box: a #GimpIntComboBox
- * @value: return location for the integer value
+ * @value: (out): return location for the integer value
*
* Retrieves the value of the selected (active) item in the @combo_box.
*
diff --git a/libgimpwidgets/gimppageselector.c b/libgimpwidgets/gimppageselector.c
index a37daadf41..4e16d3023b 100644
--- a/libgimpwidgets/gimppageselector.c
+++ b/libgimpwidgets/gimppageselector.c
@@ -856,10 +856,10 @@ gimp_page_selector_page_is_selected (GimpPageSelector *selector,
/**
* gimp_page_selector_get_selected_pages:
* @selector: Pointer to a #GimpPageSelector.
- * @n_selected_pages: Returns the number of selected pages.
+ * @n_selected_pages: (out): Returns the number of selected pages.
*
- * Returns: A sorted array of page numbers of selected pages. Use g_free() if
- * you don't need the array any longer.
+ * Returns: (array length=n_selected_pages): A sorted array of page numbers of
+ * selected pages. Use g_free() if you don't need the array any longer
*
* Since: 2.4
**/
diff --git a/libgimpwidgets/gimppreview.c b/libgimpwidgets/gimppreview.c
index 4b0ae0df0f..7b1df2a7cb 100644
--- a/libgimpwidgets/gimppreview.c
+++ b/libgimpwidgets/gimppreview.c
@@ -617,6 +617,14 @@ gimp_preview_set_bounds (GimpPreview *preview,
ymax - ymin);
}
+/**
+ * gimp_preview_get_bounds:
+ * @preview: A #GimpPreview:
+ * @xmin: (out) (optional): Lower bound for x
+ * @ymin: (out) (optional): Lower bound for y
+ * @xmax: (out) (optional): Higher bound for x
+ * @ymax: (out) (optional): Higher bound for y
+ */
void
gimp_preview_get_bounds (GimpPreview *preview,
gint *xmin,
@@ -691,6 +699,12 @@ gimp_preview_set_offsets (GimpPreview *preview,
priv->yoff = yoff;
}
+/**
+ * gimp_preview_get_offsets:
+ * @preview: A #GimpPreview:
+ * @xoff: (out) (optional): X offset
+ * @yoff: (out) (optional): Y offset
+ */
void
gimp_preview_get_offsets (GimpPreview *preview,
gint *xoff,
@@ -734,8 +748,8 @@ gimp_preview_get_position (GimpPreview *preview,
* @preview: a #GimpPreview widget
* @src_x: horizontal position on the previewed image
* @src_y: vertical position on the previewed image
- * @dest_x: returns the transformed horizontal position
- * @dest_y: returns the transformed vertical position
+ * @dest_x: (out): returns the transformed horizontal position
+ * @dest_y: (out): returns the transformed vertical position
*
* Transforms from image to widget coordinates.
*
@@ -760,8 +774,8 @@ gimp_preview_transform (GimpPreview *preview,
* @preview: a #GimpPreview widget
* @src_x: horizontal position relative to the preview area's origin
* @src_y: vertical position relative to preview area's origin
- * @dest_x: returns the untransformed horizontal position
- * @dest_y: returns the untransformed vertical position
+ * @dest_x: (out): returns the untransformed horizontal position
+ * @dest_y: (out): returns the untransformed vertical position
*
* Transforms from widget to image coordinates.
*
@@ -859,7 +873,7 @@ gimp_preview_draw (GimpPreview *preview)
/**
* gimp_preview_draw_buffer:
* @preview: a #GimpPreview widget
- * @buffer: a pixel buffer the size of the preview
+ * @buffer: (array): a pixel buffer the size of the preview
* @rowstride: the @buffer's rowstride
*
* Calls the GimpPreview::draw_buffer method. GimpPreview itself
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]