## gimppixbuf

gimppixbuf — Get a thumbnail pixbuf for a drawable or image.

## Synopsis

    enum        GimpPixbufTransparency;
    GdkPixbuf*  gimp_image_get_thumbnail        (gint32 image_ID,
                                                 gint width,
                                                 gint height,
                                                 GimpPixbufTransparency alpha);
    GdkPixbuf*  gimp_drawable_get_thumbnail     (gint32 drawable_ID,
                                                 gint width,
                                                 gint height,
                                                 GimpPixbufTransparency alpha);
    GdkPixbuf*  gimp_drawable_get_sub_thumbnail (gint32 drawable_ID,
                                                 gint src_x,
                                                 gint src_y,
                                                 gint src_width,
                                                 gint src_height,
                                                 gint dest_width,
                                                 gint dest_height,
                                                 GimpPixbufTransparency alpha);

## Description

Get a thumbnail pixbuf for a drawable or image.

## Details

### enum GimpPixbufTransparency

    typedef enum
    {
      GIMP_PIXBUF_KEEP_ALPHA,
      GIMP_PIXBUF_SMALL_CHECKS,
      GIMP_PIXBUF_LARGE_CHECKS
    } GimpPixbufTransparency;

### gimp_image_get_thumbnail ()

    GdkPixbuf*  gimp_image_get_thumbnail        (gint32 image_ID,
                                                 gint width,
                                                 gint height,
                                                 GimpPixbufTransparency alpha);

Retrieves a thumbnail pixbuf for the image identified by `image_ID`. The thumbnail will be not larger than the requested size.

`image_ID` : | the image ID
`width` : | the requested thumbnail width (<= 512 pixels)
`height` : | the requested thumbnail height (<= 512 pixels)
`alpha` : | how to handle an alpha channel
Returns : | a new GdkPixbuf

Since GIMP 2.2

### gimp_drawable_get_thumbnail ()

    GdkPixbuf*  gimp_drawable_get_thumbnail     (gint32 drawable_ID,
                                                 gint width,
                                                 gint height,
                                                 GimpPixbufTransparency alpha);

Retrieves a thumbnail pixbuf for the drawable identified by `drawable_ID`. The thumbnail will be not larger than the requested size.

`drawable_ID` : | the drawable ID
`width` : | the requested thumbnail width (<= 512 pixels)
`height` : | the requested thumbnail height (<= 512 pixels)
`alpha` : | how to handle an alpha channel
Returns : | a new GdkPixbuf

Since GIMP 2.2

### gimp_drawable_get_sub_thumbnail ()

    GdkPixbuf*  gimp_drawable_get_sub_thumbnail (gint32 drawable_ID,
                                                 gint src_x,
                                                 gint src_y,
                                                 gint src_width,
                                                 gint src_height,
                                                 gint dest_width,
                                                 gint dest_height,
                                                 GimpPixbufTransparency alpha);

Retrieves a thumbnail pixbuf for the drawable identified by `drawable_ID`. The thumbnail will be not larger than the requested size.

`drawable_ID` : | 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` : | the requested thumbnail width (<= 512 pixels)
`dest_height` : | the requested thumbnail height (<= 512 pixels)
`alpha` : | how to handle an alpha channel
Returns : | a new GdkPixbuf

Since GIMP 2.2