Gimp.RunThumbnailFunc
Description: Reference for Gimp.RunThumbnailFunc

### Function

# GimpRunThumbnailFunc

unstable 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: `GimpProcedure`

  The `GimpProcedure` that runs.

  The data is owned by the caller of the function.

`file`

  Type: `GFile`

  The `GFile` to load the thumbnail from.

  The data is owned by the caller of the function.

`size`

  Type: `gint`

  The requested thumbnail size.

`config`

  Type: `GimpProcedureConfig`

  The `procedure`‘s remaining arguments.

  The data is owned by the caller of the function.

`run_data`

  Type: `gpointer`

  The 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.