libgimp: add a doc comment to gimp_drawable_get_sub_thumbnail_data().

This was added in commit e24375e64a together with "Since:" annotation
updates, which got reverted. Add back just the documentation comment.
This commit is contained in:
Jehan 2019-09-02 11:47:01 +02:00
parent 1c0fb800e5
commit 650d4b57ed

View file

@ -133,6 +133,23 @@ gimp_drawable_get_thumbnail (GimpDrawable *drawable,
return NULL;
}
/**
* gimp_drawable_get_sub_thumbnail_data:
* @drawable: the drawable ID
* @src_x: the x coordinate of the area
* @src_y: the y coordinate of the area
* @src_width: the width of the area
* @src_height: the height of the area
* @dest_width: (inout): the requested thumbnail width (<= 1024 pixels)
* @dest_height: (inout): the requested thumbnail height (<= 1024 pixels)
* @bpp: (out): the bytes per pixel of the returned thumbnail data
*
* Retrieves thumbnail data for the drawable identified by @drawable.
* The thumbnail will be not larger than the requested size.
*
* Returns: (transfer full) (nullable): thumbnail data or %NULL if
* @drawable is invalid.
**/
guchar *
gimp_drawable_get_sub_thumbnail_data (GimpDrawable *drawable,
gint src_x,