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);
gint32              gimp_layer_new_from_pixbuf          (gint32 image_ID,
                                                         const gchar *name,
                                                         GdkPixbuf *pixbuf,
                                                         gdouble opacity,
                                                         GimpLayerModeEffects mode,
                                                         gdouble progress_start,
                                                         gdouble progress_end);

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

Since GIMP 2.2


gimp_layer_new_from_pixbuf ()

gint32              gimp_layer_new_from_pixbuf          (gint32 image_ID,
                                                         const gchar *name,
                                                         GdkPixbuf *pixbuf,
                                                         gdouble opacity,
                                                         GimpLayerModeEffects mode,
                                                         gdouble progress_start,
                                                         gdouble progress_end);

Create a new layer from a GdkPixbuf.

This procedure creates a new layer from the given GdkPixbuf. The image has to be an RGB image and just like with gimp_layer_new() you will still need to add the layer to it.

If you pass progress_end > progress_start to this function, gimp_progress_update() will be called for. You have to call gimp_progress_init() beforehand then.

image_ID : The RGB image to which to add the layer.
name : The layer name.
pixbuf : A GdkPixbuf.
opacity : The layer opacity.
mode : The layer combination mode.
progress_start : start of progress
progress_end : end of progress
Returns : The newly created layer.

Since GIMP 2.4