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

pdb: add (element-type foo) annotations to all returned arrays

This commit is contained in:
Michael Natterer 2019-07-31 13:08:19 +02:00
parent 5b6cfd9863
commit e8c6ab7ce9
21 changed files with 74 additions and 62 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
libgimp/gimp_pdb.c
View File

@ -213,8 +213,9 @@ gimp_get_parasite (const gchar *name)
*
* Returns a list of all currently attached global parasites.
*
* Returns: (transfer full) The names of currently attached parasites.
* The returned value must be freed with g_strfreev().
* Returns: (element-type gchar*) (transfer full) The names of
* currently attached parasites. The returned value must be freed with
* g_strfreev().
*
* Since: 2.8
**/

4
libgimp/gimpbrush_pdb.c
View File

@ -313,10 +313,10 @@ gimp_brush_get_info (const gchar *name,
* @height: The brush height.
* @mask_bpp: The brush mask bpp.
* @num_mask_bytes: Length of brush mask data.
* @mask_bytes: (transfer full) The brush mask data.
* @mask_bytes: (element-type guint8) (transfer full) The brush mask data.
* @color_bpp: The brush color bpp.
* @num_color_bytes: Length of brush color data.
* @color_bytes: (transfer full) The brush color data.
* @color_bytes: (element-type guint8) (transfer full) The brush color data.
*
* Retrieves information about the specified brush.
*

4
libgimp/gimpbrushes_pdb.c
View File

@ -75,8 +75,8 @@ gimp_brushes_refresh (void)
* Each name returned can be used as input to the
* gimp_context_set_brush() procedure.
*
* Returns: (transfer full) The list of brush names. The returned value
* must be freed with g_strfreev().
* Returns: (element-type gchar*) (transfer full) The list of brush
* names. The returned value must be freed with g_strfreev().
**/
gchar **
gimp_brushes_get_list (const gchar *filter,

4
libgimp/gimpbuffer_pdb.c
View File

@ -44,8 +44,8 @@
* This procedure returns a complete listing of available named
* buffers.
*
* Returns: (transfer full) The list of buffer names. The returned
* value must be freed with g_strfreev().
* Returns: (element-type gchar*) (transfer full) The list of buffer
* names. The returned value must be freed with g_strfreev().
*
* Since: 2.4
**/

4
libgimp/gimpcontext_pdb.c
View File

@ -139,7 +139,7 @@ gimp_context_set_defaults (void)
/**
* gimp_context_list_paint_methods:
* @num_paint_methods: The number of the available paint methods.
* @paint_methods: (transfer full) The names of the available paint methods.
* @paint_methods: (element-type gchar*) (transfer full) The names of the available paint methods.
*
* Lists the available paint methods.
*
@ -1100,7 +1100,7 @@ gimp_context_set_line_dash_offset (gdouble dash_offset)
/**
* gimp_context_get_line_dash_pattern:
* @num_dashes: The number of dashes in the dash_pattern array.
* @dashes: (transfer full) The line dash pattern setting.
* @dashes: (elemen-type gdouble) (transfer full) The line dash pattern setting.
*
* Get the line dash pattern setting.
*

6
libgimp/gimpdrawable_pdb.c
View File

@ -714,7 +714,7 @@ gimp_drawable_update (gint32 drawable_ID,
* The 'num_channels' argument must always be equal to the
* bytes-per-pixel value for the specified drawable.
*
* Returns: (transfer full) The pixel value.
* Returns: (element-type guint8) (transfer full) The pixel value.
**/
guint8 *
gimp_drawable_get_pixel (gint32 drawable_ID,
@ -912,7 +912,7 @@ gimp_drawable_offset (gint32 drawable_ID,
* @actual_height: The previews height.
* @bpp: The previews bpp.
* @thumbnail_data_count: The number of bytes in thumbnail data.
* @thumbnail_data: (transfer full) The thumbnail data.
* @thumbnail_data: (element-type guint8) (transfer full) The thumbnail data.
*
* Get a thumbnail of a drawable.
*
@ -984,7 +984,7 @@ _gimp_drawable_thumbnail (gint32 drawable_ID,
* @height: The previews height.
* @bpp: The previews bpp.
* @thumbnail_data_count: The number of bytes in thumbnail data.
* @thumbnail_data: (transfer full) The thumbnail data.
* @thumbnail_data: (element-type guint8) (transfer full) The thumbnail data.
*
* Get a thumbnail of a sub-area of a drawable drawable.
*

4
libgimp/gimpdynamics_pdb.c
View File

@ -77,8 +77,8 @@ gimp_dynamics_refresh (void)
* This procedure returns a list of the paint dynamics that are
* currently available.
*
* Returns: (transfer full) The list of paint dynamics names. The
* returned value must be freed with g_strfreev().
* Returns: (element-type gchar*) (transfer full) The list of paint
* dynamics names. The returned value must be freed with g_strfreev().
*
* Since: 2.8
**/

3
libgimp/gimpfileops_pdb.c
View File

@ -141,7 +141,8 @@ gimp_file_load_layer (GimpRunMode run_mode,
* needs to be added to the existing image with
* gimp_image_insert_layer().
*
* Returns: (transfer full) The list of loaded layers.
* Returns: (element-type gint32) (transfer full) The list of loaded
* layers.
*
* Since: 2.4
**/

4
libgimp/gimpfonts_pdb.c
View File

@ -75,8 +75,8 @@ gimp_fonts_refresh (void)
* This procedure returns a list of the fonts that are currently
* available.
*
* Returns: (transfer full) The list of font names. The returned value
* must be freed with g_strfreev().
* Returns: (element-type gchar*) (transfer full) The list of font
* names. The returned value must be freed with g_strfreev().
**/
gchar **
gimp_fonts_get_list (const gchar *filter,

4
libgimp/gimpgradient_pdb.c
View File

@ -254,7 +254,7 @@ gimp_gradient_get_number_of_segments (const gchar *name)
* @num_samples: The number of samples to take.
* @reverse: Use the reverse gradient.
* @num_color_samples: Length of the color_samples array (4 * num_samples).
* @color_samples: (transfer full) Color samples: { R1, G1, B1, A1, ..., Rn, Gn, Bn, An }.
* @color_samples: (elemen-type gdouble) (transfer full) Color samples: { R1, G1, B1, A1, ..., Rn, Gn, Bn, An }.
*
* Sample the specified in uniform parts.
*
@ -316,7 +316,7 @@ gimp_gradient_get_uniform_samples (const gchar *name,
* @positions: The list of positions to sample along the gradient.
* @reverse: Use the reverse gradient.
* @num_color_samples: Length of the color_samples array (4 * num_samples).
* @color_samples: (transfer full) Color samples: { R1, G1, B1, A1, ..., Rn, Gn, Bn, An }.
* @color_samples: (elemen-type gdouble) (transfer full) Color samples: { R1, G1, B1, A1, ..., Rn, Gn, Bn, An }.
*
* Sample the specified gradient in custom positions.
*

4
libgimp/gimpgradients_pdb.c
View File

@ -75,8 +75,8 @@ gimp_gradients_refresh (void)
* loaded. You can later use the gimp_context_set_gradient() function
* to set the active gradient.
*
* Returns: (transfer full) The list of gradient names. The returned
* value must be freed with g_strfreev().
* Returns: (element-type gchar*) (transfer full) The list of gradient
* names. The returned value must be freed with g_strfreev().
**/
gchar **
gimp_gradients_get_list (const gchar *filter,

30
libgimp/gimpimage_pdb.c
View File

@ -79,8 +79,8 @@ gimp_image_is_valid (gint32 image_ID)
*
* This procedure returns the list of images currently open in GIMP.
*
* Returns: (transfer full) The list of images currently open. The
* returned value must be freed with g_free().
* Returns: (element-type gint32) (transfer full) The list of images
* currently open. The returned value must be freed with g_free().
**/
gint *
gimp_image_list (gint *num_images)
@ -462,8 +462,9 @@ gimp_image_height (gint32 image_ID)
* This procedure returns the list of layers contained in the specified
* image. The order of layers is from topmost to bottommost.
*
* Returns: (transfer full) The list of layers contained in the image.
* The returned value must be freed with g_free().
* Returns: (element-type gint32) (transfer full) The list of layers
* contained in the image. The returned value must be freed with
* g_free().
**/
gint *
gimp_image_get_layers (gint32 image_ID,
@ -507,8 +508,9 @@ gimp_image_get_layers (gint32 image_ID,
* \"channels\" are custom channels and do not include the image's
* color components.
*
* Returns: (transfer full) The list of channels contained in the
* image. The returned value must be freed with g_free().
* Returns: (element-type gint32) (transfer full) The list of channels
* contained in the image. The returned value must be freed with
* g_free().
**/
gint *
gimp_image_get_channels (gint32 image_ID,
@ -549,8 +551,9 @@ gimp_image_get_channels (gint32 image_ID,
* This procedure returns the list of vectors contained in the
* specified image.
*
* Returns: (transfer full) The list of vectors contained in the image.
* The returned value must be freed with g_free().
* Returns: (element-type gint32) (transfer full) The list of vectors
* contained in the image. The returned value must be freed with
* g_free().
*
* Since: 2.4
**/
@ -1728,8 +1731,8 @@ gimp_image_merge_down (gint32 image_ID,
* 3. If the image is not in Indexed color mode, no colormap is
* returned.
*
* Returns: (transfer full) The image's colormap. The returned value
* must be freed with g_free().
* Returns: (element-type guint8) (transfer full) The image's colormap.
* The returned value must be freed with g_free().
**/
guint8 *
_gimp_image_get_colormap (gint32 image_ID,
@ -1955,7 +1958,7 @@ gimp_image_is_dirty (gint32 image_ID)
* @actual_height: The previews height.
* @bpp: The previews bpp.
* @thumbnail_data_count: The number of bytes in thumbnail data.
* @thumbnail_data: (transfer full) The thumbnail data.
* @thumbnail_data: (element-type guint8) (transfer full) The thumbnail data.
*
* Get a thumbnail of an image.
*
@ -3311,8 +3314,9 @@ gimp_image_get_parasite (gint32 image_ID,
*
* Returns a list of all currently attached parasites.
*
* Returns: (transfer full) The names of currently attached parasites.
* The returned value must be freed with g_strfreev().
* Returns: (element-type gchar*) (transfer full) The names of
* currently attached parasites. The returned value must be freed with
* g_strfreev().
*
* Since: 2.8
**/

10
libgimp/gimpimagecolorprofile_pdb.c
View File

@ -44,8 +44,9 @@
* This procedure returns the image's color profile, or NULL if the
* image has no color profile assigned.
*
* Returns: (transfer full) The image's serialized color profile. The
* returned value must be freed with g_free().
* Returns: (element-type guint8) (transfer full) The image's
* serialized color profile. The returned value must be freed with
* g_free().
*
* Since: 2.10
**/
@ -91,8 +92,9 @@ _gimp_image_get_color_profile (gint32 image_ID,
* or a generated default RGB or grayscale profile, according to the
* image's type.
*
* Returns: (transfer full) The image's serialized color profile. The
* returned value must be freed with g_free().
* Returns: (element-type guint8) (transfer full) The image's
* serialized color profile. The returned value must be freed with
* g_free().
*
* Since: 2.10
**/

8
libgimp/gimpitem_pdb.c
View File

@ -469,7 +469,8 @@ gimp_item_get_parent (gint32 item_ID)
* This procedure returns the list of items which are children of the
* specified item. The order is topmost to bottommost.
*
* Returns: (transfer full) The item's list of children.
* Returns: (element-type gint32) (transfer full) The item's list of
* children.
*
* Since: 2.8
**/
@ -1216,8 +1217,9 @@ gimp_item_get_parasite (gint32 item_ID,
*
* Returns a list of all parasites currently attached the an item.
*
* Returns: (transfer full) The names of currently attached parasites.
* The returned value must be freed with g_strfreev().
* Returns: (element-type gchar*) (transfer full) The names of
* currently attached parasites. The returned value must be freed with
* g_strfreev().
*
* Since: 2.8
**/

3
libgimp/gimppalette_pdb.c
View File

@ -263,7 +263,8 @@ gimp_palette_get_info (const gchar *name,
*
* This procedure retrieves all color entries of the specified palette.
*
* Returns: (transfer full) The colors in the palette.
* Returns: (element-type GimpRGB) (transfer full) The colors in the
* palette.
*
* Since: 2.6
**/

4
libgimp/gimppalettes_pdb.c
View File

@ -75,8 +75,8 @@ gimp_palettes_refresh (void)
* Each name returned can be used as input to the command
* gimp_context_set_palette().
*
* Returns: (transfer full) The list of palette names. The returned
* value must be freed with g_strfreev().
* Returns: (element-type gchar*) (transfer full) The list of palette
* names. The returned value must be freed with g_strfreev().
**/
gchar **
gimp_palettes_get_list (const gchar *filter,

2
libgimp/gimppattern_pdb.c
View File

@ -93,7 +93,7 @@ gimp_pattern_get_info (const gchar *name,
* @height: The pattern height.
* @bpp: The pattern bpp.
* @num_color_bytes: Number of pattern bytes.
* @color_bytes: (transfer full) The pattern data.
* @color_bytes: (element-type guint8) (transfer full) The pattern data.
*
* Retrieve information about the specified pattern (including pixels).
*

4
libgimp/gimppatterns_pdb.c
View File

@ -75,8 +75,8 @@ gimp_patterns_refresh (void)
* patterns. Each name returned can be used as input to the
* gimp_context_set_pattern().
*
* Returns: (transfer full) The list of pattern names. The returned
* value must be freed with g_strfreev().
* Returns: (element-type gchar*) (transfer full) The list of pattern
* names. The returned value must be freed with g_strfreev().
**/
gchar **
gimp_patterns_get_list (const gchar *filter,

4
libgimp/gimpproceduraldb_pdb.c
View File

@ -111,7 +111,7 @@ gimp_procedural_db_dump (const gchar *filename)
* @date: The regex for procedure date.
* @proc_type: The regex for procedure type: { 'Internal GIMP procedure', 'GIMP Plug-in', 'GIMP Extension', 'Temporary Procedure' }.
* @num_matches: The number of matching procedures.
* @procedure_names: (transfer full) The list of procedure names.
* @procedure_names: (element-type gchar*) (transfer full) The list of procedure names.
*
* Queries the procedural database for its contents using regular
* expression matching.
@ -408,7 +408,7 @@ gimp_procedural_db_proc_val (const gchar *procedure_name,
* _gimp_procedural_db_get_data:
* @identifier: The identifier associated with data.
* @bytes: The number of bytes in the data.
* @data: (transfer full) A byte array containing data.
* @data: (element-type guint8) (transfer full) A byte array containing data.
*
* Returns data associated with the specified identifier.
*

13
libgimp/gimpvectors_pdb.c
View File

@ -161,7 +161,8 @@ gimp_vectors_copy (gint32 vectors_ID)
* Returns an Array with the stroke-IDs associated with the passed
* path.
*
* Returns: (transfer full) List of the strokes belonging to the path.
* Returns: (element-type gint32) (transfer full) List of the strokes
* belonging to the path.
*
* Since: 2.4
**/
@ -634,7 +635,7 @@ gimp_vectors_stroke_flip_free (gint32 vectors_ID,
* @vectors_ID: The vectors object.
* @stroke_id: The stroke ID.
* @num_points: The number of floats returned.
* @controlpoints: (transfer full) List of the control points for the stroke (x0, y0, x1, y1, ...).
* @controlpoints: (elemen-type gdouble) (transfer full) List of the control points for the stroke (x0, y0, x1, y1, ...).
* @closed: Whether the stroke is closed or not.
*
* returns the control points of a stroke.
@ -755,8 +756,8 @@ gimp_vectors_stroke_new_from_points (gint32 vectors_ID,
*
* returns polygonal approximation of the stroke.
*
* Returns: (transfer full) List of the coords along the path (x0, y0,
* x1, y1, ...).
* Returns: (elemen-type gdouble) (transfer full) List of the coords
* along the path (x0, y0, x1, y1, ...).
*
* Since: 2.4
**/
@ -1066,7 +1067,7 @@ gimp_vectors_bezier_stroke_new_ellipse (gint32 vectors_ID,
* @merge: Merge paths into a single vectors object.
* @scale: Scale the SVG to image dimensions.
* @num_vectors: The number of newly created vectors.
* @vectors_ids: (transfer full) The list of newly created vectors.
* @vectors_ids: (element-type gint32) (transfer full) The list of newly created vectors.
*
* Import paths from an SVG file.
*
@ -1127,7 +1128,7 @@ gimp_vectors_import_from_file (gint32 image_ID,
* @merge: Merge paths into a single vectors object.
* @scale: Scale the SVG to image dimensions.
* @num_vectors: The number of newly created vectors.
* @vectors_ids: (transfer full) The list of newly created vectors.
* @vectors_ids: (element-type gint32) (transfer full) The list of newly created vectors.
*
* Import paths from an SVG string.
*

12
pdb/pdb.pl
View File

@ -74,7 +74,7 @@ package Gimp::CodeGen::pdb;
const_type => 'const gint32 *',
array => 1,
init_value => 'NULL',
return_annotate => '(transfer full)',
return_annotate => '(element-type gint32) (transfer full)',
get_value_func => '$var = gimp_value_get_int32_array ($value)',
dup_value_func => '$var = gimp_value_dup_int32_array ($value)',
set_value_func => 'gimp_value_set_int32_array ($value, $var, $var_len)',
@ -86,7 +86,7 @@ package Gimp::CodeGen::pdb;
const_type => 'const gint16 *',
array => 1,
init_value => 'NULL',
return_annotate => '(transfer full)',
return_annotate => '(element-type gint16) (transfer full)',
get_value_func => '$var = gimp_value_get_int16_array ($value)',
dup_value_func => '$var = gimp_value_dup_int16_array ($value)',
set_value_func => 'gimp_value_set_int16_array ($value, $var, $var_len)',
@ -98,7 +98,7 @@ package Gimp::CodeGen::pdb;
const_type => 'const guint8 *',
array => 1,
init_value => 'NULL',
return_annotate => '(transfer full)',
return_annotate => '(element-type guint8) (transfer full)',
get_value_func => '$var = gimp_value_get_int8_array ($value)',
dup_value_func => '$var = gimp_value_dup_int8_array ($value)',
set_value_func => 'gimp_value_set_int8_array ($value, $var, $var_len)',
@ -110,7 +110,7 @@ package Gimp::CodeGen::pdb;
const_type => 'const gdouble *',
array => 1,
init_value => 'NULL',
return_annotate => '(transfer full)',
return_annotate => '(elemen-type gdouble) (transfer full)',
get_value_func => '$var = gimp_value_get_float_array ($value)',
dup_value_func => '$var = gimp_value_dup_float_array ($value)',
set_value_func => 'gimp_value_set_float_array ($value, $var, $var_len)',
@ -122,7 +122,7 @@ package Gimp::CodeGen::pdb;
const_type => 'const gchar **',
array => 1,
init_value => 'NULL',
return_annotate => '(transfer full)',
return_annotate => '(element-type gchar*) (transfer full)',
get_value_func => '$var = gimp_value_get_string_array ($value)',
dup_value_func => '$var = gimp_value_dup_string_array ($value)',
set_value_func => 'gimp_value_set_string_array ($value, $var, $var_len)',
@ -134,7 +134,7 @@ package Gimp::CodeGen::pdb;
const_type => 'const GimpRGB *',
array => 1,
init_value => 'NULL',
return_annotate => '(transfer full)',
return_annotate => '(element-type GimpRGB) (transfer full)',
get_value_func => '$var = gimp_value_get_rgb_array ($value)',
dup_value_func => '$var = gimp_value_dup_rgb_array ($value)',
set_value_func => 'gimp_value_set_rgb_array ($value, $var, $var_len)',