## GimpDrawablePreview GimpDrawablePreview — A widget providing a preview of a GimpDrawable. |

## Synopsis

                GimpDrawablePreview;
    GtkWidget*  gimp_drawable_preview_new       (GimpDrawable *drawable,
                                                 gboolean *toggle);
    GimpDrawable* gimp_drawable_preview_get_drawable
                                                (GimpDrawablePreview *preview);
    void        gimp_drawable_preview_draw_region
                                                (GimpDrawablePreview *preview,
                                                 const GimpPixelRgn *region);

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----GtkObject
                   +----GtkWidget
                         +----GtkContainer
                               +----GtkBox
                                     +----GtkVBox
                                           +----GimpPreview
                                                 +----GimpScrolledPreview
                                                       +----GimpDrawablePreview

## Implemented Interfaces

GimpDrawablePreview implements AtkImplementorIface.

## Properties

      "drawable"             gpointer              : Read / Write / Construct Only

## Description

A widget providing a preview of a GimpDrawable.

## Details

### GimpDrawablePreview

    typedef struct _GimpDrawablePreview GimpDrawablePreview;

### gimp_drawable_preview_new ()

    GtkWidget*  gimp_drawable_preview_new       (GimpDrawable *drawable,
                                                 gboolean *toggle);

Creates a new GimpDrawablePreview widget for `drawable`. If updating the preview takes considerable time, you will want to store the state of the "Preview" check-button in the plug-in data. For convenience you can pass a pointer to the gboolean as `toggle`.

`drawable` : | a GimpDrawable
`toggle` : | pointer to a gboolean variable to sync with the "Preview" check-button or `NULL`
Returns : | A pointer to the new GimpDrawablePreview widget.

Since GIMP 2.2

### gimp_drawable_preview_get_drawable ()

    GimpDrawable* gimp_drawable_preview_get_drawable
                                                (GimpDrawablePreview *preview);

`preview` : | a GimpDrawablePreview widget
Returns : | the GimpDrawable that has been passed to `gimp_drawable_preview_new()`.

Since GIMP 2.2

### gimp_drawable_preview_draw_region ()

    void        gimp_drawable_preview_draw_region
                                                (GimpDrawablePreview *preview,
                                                 const GimpPixelRgn *region);

`preview` : | a GimpDrawablePreview widget
`region` : | a GimpPixelRgn

Since GIMP 2.2

## Properties

### The "`drawable`" property

      "drawable"             gpointer              : Read / Write / Construct Only

Since GIMP 2.4