Function
GimpRunThumbnailFunc
since: 3.0
Declaration
GimpValueArray*
(* GimpRunThumbnailFunc) (
GimpProcedure* procedure,
GFile* file,
gint size,
GimpProcedureConfig* config,
gpointer run_data
)
Description [src]
The thumbnail function is run during the lifetime of the GIMP session, each time a plug-in thumbnail procedure is called.
GimpThumbnailProcedure are always run non-interactively.
On success, the returned array must contain:
1. a GimpImage: this is the only mandatory return value. It should
ideally be a simple image whose dimensions are closest to size and meant
to be displayed as a small static image.
2. (optional) the full image’s width (not the thumbnail’s image’s), or 0 if
unknown.
3. (optional) the full image’s height, or 0 if unknown.
4. (optional) the GimpImageType of the full image.
5. (optional) the number of layers in the full image.
Available since: 3.0
Parameters
procedure-
Type:
GimpProcedureThe
GimpProcedurethat runs.The data is owned by the caller of the function. file-
Type:
GFileThe
GFileto load the thumbnail from.The data is owned by the caller of the function. size-
Type:
gintThe requested thumbnail size.
config-
Type:
GimpProcedureConfigThe
procedure‘s remaining arguments.The data is owned by the caller of the function. run_data-
Type:
gpointerThe run_data given in gimp_thumbnail_procedure_new().
The argument can be NULL.The data is owned by the caller of the function.
Return value
Type: GimpValueArray
The procedure‘s return values.
| The caller of the function takes ownership of the data, and is responsible for freeing it. |