## 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 and GtkBuildable.

## 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`.

In GIMP 2.2 the `toggle` parameter was provided to conviently access the state of the "Preview" check-button. This is not any longer necessary as the preview itself now stores this state, as well as the scroll offset.

`drawable` : | a GimpDrawable
`toggle` : | unused
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

## Property Details

### The `"drawable"` property

      "drawable"                 gpointer              : Read / Write / Construct Only

Since GIMP 2.4