dnrops
/
gimp
mirror of https://github.com/GNOME/gimp.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

pdb, libgimp*: add (out caller-allocates) to all GimpRGB* return values

This commit is contained in:
Michael Natterer 2019-08-01 15:39:13 +02:00
parent bdac38a854
commit c12c031f2d
16 changed files with 41 additions and 28 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
libgimp/gimpchannel_pdb.c
View File

@ -369,7 +369,7 @@ gimp_channel_set_opacity (gint32 channel_ID,
/**
* gimp_channel_get_color:
* @channel_ID: The channel.
* @color: (out): The channel compositing color.
* @color: (out caller-allocates): The channel compositing color.
*
* Get the compositing color of the specified channel.
*

4
libgimp/gimpcontext_pdb.c
View File

@ -322,7 +322,7 @@ gimp_context_set_stroke_method (GimpStrokeMethod stroke_method)
/**
* gimp_context_get_foreground:
* @foreground: (out): The foreground color.
* @foreground: (out caller-allocates): The foreground color.
*
* Get the current GIMP foreground color.
*
@ -395,7 +395,7 @@ gimp_context_set_foreground (const GimpRGB *foreground)
/**
* gimp_context_get_background:
* @background: (out): The background color.
* @background: (out caller-allocates): The background color.
*
* Get the current GIMP background color.
*

4
libgimp/gimpgradient_pdb.c
View File

@ -377,7 +377,7 @@ gimp_gradient_get_custom_samples (const gchar *name,
* gimp_gradient_segment_get_left_color:
* @name: The gradient name.
* @segment: The index of the segment within the gradient.
* @color: (out): The return color.
* @color: (out caller-allocates): The return color.
* @opacity: (out): The opacity of the endpoint.
*
* Retrieves the left endpoint color of the specified segment
@ -475,7 +475,7 @@ gimp_gradient_segment_set_left_color (const gchar *name,
* gimp_gradient_segment_get_right_color:
* @name: The gradient name.
* @segment: The index of the segment within the gradient.
* @color: (out): The return color.
* @color: (out caller-allocates): The return color.
* @opacity: (out): The opacity of the endpoint.
*
* Retrieves the right endpoint color of the specified segment

2
libgimp/gimpimage_pdb.c
View File

@ -738,7 +738,7 @@ gimp_image_floating_sel_attached_to (gint32 image_ID)
* @sample_merged: Use the composite image, not the drawable.
* @sample_average: Average the color of all the pixels in a specified radius.
* @average_radius: The radius of pixels to average.
* @color: (out): The return color.
* @color: (out caller-allocates): The return color.
*
* Determine the color at the given drawable coordinates
*

4
libgimp/gimpimagegrid_pdb.c
View File

@ -219,7 +219,7 @@ gimp_image_grid_set_offset (gint32 image_ID,
/**
* gimp_image_grid_get_foreground_color:
* @image_ID: The image.
* @fgcolor: (out): The image's grid foreground color.
* @fgcolor: (out caller-allocates): The image's grid foreground color.
*
* Sets the foreground color of an image's grid.
*
@ -296,7 +296,7 @@ gimp_image_grid_set_foreground_color (gint32 image_ID,
/**
* gimp_image_grid_get_background_color:
* @image_ID: The image.
* @bgcolor: (out): The image's grid background color.
* @bgcolor: (out caller-allocates): The image's grid background color.
*
* Sets the background color of an image's grid.
*

2
libgimp/gimppalette_pdb.c
View File

@ -466,7 +466,7 @@ gimp_palette_delete_entry (const gchar *name,
* gimp_palette_entry_get_color:
* @name: The palette name.
* @entry_num: The entry to retrieve.
* @color: (out): The color requested.
* @color: (out caller-allocates): The color requested.
*
* Gets the specified palette entry from the specified palette.
*

2
libgimp/gimptextlayer_pdb.c
View File

@ -817,7 +817,7 @@ gimp_text_layer_set_justification (gint32 layer_ID,
/**
* gimp_text_layer_get_color:
* @layer_ID: The text layer.
* @color: (out): The color of the text.
* @color: (out caller-allocates): The color of the text.
*
* Get the color of the text in a text layer.
*

14
libgimpcolor/gimpcolorspace.c
View File

@ -53,7 +53,7 @@
/**
* gimp_rgb_to_hsv:
* @rgb: A color value in the RGB colorspace
* @hsv: The value converted to the HSV colorspace
* @hsv: (out caller-allocates): The value converted to the HSV colorspace
*
* Does a conversion from RGB to HSV (Hue, Saturation,
* Value) colorspace.
@ -106,7 +106,7 @@ gimp_rgb_to_hsv (const GimpRGB *rgb,
/**
* gimp_hsv_to_rgb:
* @hsv: A color value in the HSV colorspace
* @rgb: The returned RGB value.
* @rgb: (out caller-allocates): The returned RGB value.
*
* Converts a color value from HSV to RGB colorspace
**/
@ -185,7 +185,7 @@ gimp_hsv_to_rgb (const GimpHSV *hsv,
/**
* gimp_rgb_to_hsl:
* @rgb: A color value in the RGB colorspace
* @hsl: The value converted to HSL
* @hsl: (out caller-allocates): The value converted to HSL
*
* Convert an RGB color value to a HSL (Hue, Saturation, Lightness)
* color value.
@ -271,7 +271,8 @@ gimp_hsl_value (gdouble n1,
/**
* gimp_hsl_to_rgb:
* @hsl: A color value in the HSL colorspace
* @rgb: The value converted to a value in the RGB colorspace
* @rgb: (out caller-allocates): The value converted to a value
* in the RGB colorspace
*
* Convert a HSL color value to an RGB color value.
**/
@ -314,7 +315,8 @@ gimp_hsl_to_rgb (const GimpHSL *hsl,
* @rgb: A value in the RGB colorspace
* @pullout: A scaling value (0-1) indicating how much black should be
* pulled out
* @cmyk: The input value naively converted to the CMYK colorspace
* @cmyk: (out caller-allocates): The input value naively converted
* to the CMYK colorspace
*
* Does a naive conversion from RGB to CMYK colorspace. A simple
* formula that doesn't take any color-profiles into account is used.
@ -363,7 +365,7 @@ gimp_rgb_to_cmyk (const GimpRGB *rgb,
/**
* gimp_cmyk_to_rgb:
* @cmyk: A color value in the CMYK colorspace
* @rgb: The value converted to the RGB colorspace
* @rgb: (out caller-allocates): The value converted to the RGB colorspace
*
* Does a simple transformation from the CMYK colorspace to the RGB
* colorspace, without taking color profiles into account.

4
libgimpcolor/gimprgb.c
View File

@ -159,7 +159,7 @@ gimp_rgb_set_pixel (GimpRGB *rgb,
* gimp_rgb_get_pixel:
* @rgb: a #GimpRGB struct
* @format: a Babl format
* @pixel: pointer to the destination pixel
* @pixel: (out caller-allocates): pointer to the destination pixel
*
* Writes the red, green, blue and alpha components of @rgb to the
* color stored in @pixel. The pixel format of @pixel is determined by
@ -428,7 +428,7 @@ gimp_rgba_set_pixel (GimpRGB *rgba,
* gimp_rgba_get_pixel:
* @rgba: a #GimpRGB struct
* @format: a Babl format
* @pixel: pointer to the destination pixel
* @pixel: (out caller-allocates): pointer to the destination pixel
*
* Writes the red, green, blue and alpha components of @rgba to the
* color stored in @pixel. The pixel format of @pixel is determined by

2
libgimpconfig/gimpscanner.c
View File

@ -649,7 +649,7 @@ enum
* gimp_scanner_parse_color:
* @scanner: A #GScanner created by gimp_scanner_new_file() or
* gimp_scanner_new_string()
* @dest: Pointer to a color to store the result
* @dest: (out caller-allocates): Pointer to a color to store the result
*
* Return value: %TRUE on success
*

5
libgimpwidgets/gimpcolorarea.c
View File

@ -554,8 +554,9 @@ gimp_color_area_set_color (GimpColorArea *area,
/**
* gimp_color_area_get_color:
* @area: Pointer to a #GimpColorArea.
* @color: Pointer to a #GimpRGB struct that is used to return the color.
* @area: Pointer to a #GimpColorArea.
* @color: (out caller-allocates): Pointer to a #GimpRGB struct
* that is used to return the color.
*
* Retrieves the current color of the @area.
**/

3
libgimpwidgets/gimpcolorbutton.c
View File

@ -725,7 +725,8 @@ gimp_color_button_set_color (GimpColorButton *button,
/**
* gimp_color_button_get_color:
* @button: Pointer to a #GimpColorButton.
* @color: Pointer to a #GimpRGB struct used to return the color.
* @color: (out caller-allocates): Pointer to a #GimpRGB struct
* used to return the color.
*
* Retrieves the currently set color from the @button.
**/

2
libgimpwidgets/gimpcolorhexentry.c
View File

@ -250,7 +250,7 @@ gimp_color_hex_entry_set_color (GimpColorHexEntry *entry,
/**
* gimp_color_hex_entry_get_color:
* @entry: a #GimpColorHexEntry widget
* @color: pointer to a #GimpRGB
* @color: (out caller-allocates): pointer to a #GimpRGB
*
* Retrieves the color value displayed by a #GimpColorHexEntry.
*

6
libgimpwidgets/gimpcolorselection.c
View File

@ -471,7 +471,8 @@ gimp_color_selection_set_color (GimpColorSelection *selection,
/**
* gimp_color_selection_get_color:
* @selection: A #GimpColorSelection widget.
* @color: (out): Return location for the @selection's current @color.
* @color: (out caller-allocates): Return location for the
* @selection's current @color.
*
* This function returns the #GimpColorSelection's current color.
**/
@ -509,7 +510,8 @@ gimp_color_selection_set_old_color (GimpColorSelection *selection,
/**
* gimp_color_selection_get_old_color:
* @selection: A #GimpColorSelection widget.
* @color: (out): Return location for the @selection's old @color.
* @color: (out caller-allocates): Return location for the
* @selection's old @color.
*
* This function returns the #GimpColorSelection's old color.
**/

5
libgimpwidgets/gimpcolorselector.c
View File

@ -377,8 +377,9 @@ gimp_color_selector_set_color (GimpColorSelector *selector,
/**
* gimp_color_selector_get_color:
* @selector: A #GimpColorSelector widget.
* @rgb: Return location for the color.
* @hsv: Return location for the same same color in HSV.
* @rgb: (out caller-allocates): Return location for the color.
* @hsv: (out caller-allocates): Return location for the same same
* color in HSV.
*
* Retrieves the color shown in the @selector widget.
*

8
pdb/lib.pl
View File

@ -353,7 +353,13 @@ CODE
$argdesc .= " * \@$_->{libname}";
$argdesc .= '_ID' if $arg->{id};
$argdesc .= ": (out)";
if ($arg->{name} eq 'COLOR') {
$argdesc .= ": (out caller-allocates)";
}
else {
$argdesc .= ": (out)";
}
if (exists $arg->{array}) {
$argdesc .= " (array length=@outargs[$argc - 2]->{name})";