GimpZoomPreview

GimpZoomPreview — A drawable preview with zooming capabilities.

Synopsis

                    GimpZoomPreview;
GtkWidget *         gimp_zoom_preview_new               (GimpDrawable *drawable);
GtkWidget *         gimp_zoom_preview_new_with_model    (GimpDrawable *drawable,
                                                         GimpZoomModel *model);
guchar *            gimp_zoom_preview_get_source        (GimpZoomPreview *preview,
                                                         gint *width,
                                                         gint *height,
                                                         gint *bpp);
GimpDrawable *      gimp_zoom_preview_get_drawable      (GimpZoomPreview *preview);
gdouble             gimp_zoom_preview_get_factor        (GimpZoomPreview *preview);
GimpZoomModel *     gimp_zoom_preview_get_model         (GimpZoomPreview *preview);

Object Hierarchy

  GObject
   +----GInitiallyUnowned
         +----GtkObject
               +----GtkWidget
                     +----GtkContainer
                           +----GtkBox
                                 +----GimpPreview
                                       +----GimpScrolledPreview
                                             +----GimpZoomPreview

Implemented Interfaces

GimpZoomPreview implements AtkImplementorIface, GtkBuildable and GtkOrientable.

Properties

  "drawable"                 gpointer              : Read / Write / Construct Only
  "model"                    GimpZoomModel*        : Read / Write / Construct Only

Description

A drawable preview with zooming capabilities.

Details

GimpZoomPreview

typedef struct _GimpZoomPreview GimpZoomPreview;


gimp_zoom_preview_new ()

GtkWidget *         gimp_zoom_preview_new               (GimpDrawable *drawable);

Creates a new GimpZoomPreview widget for drawable.

drawable :

a GimpDrawable

Returns :

a new GimpZoomPreview.

Since GIMP 2.4


gimp_zoom_preview_new_with_model ()

GtkWidget *         gimp_zoom_preview_new_with_model    (GimpDrawable *drawable,
                                                         GimpZoomModel *model);

Creates a new GimpZoomPreview widget for drawable using the given model.

This variant of gimp_zoom_preview_new() allows you to create a preview using an existing zoom model. This may be useful if for example you want to have two zoom previews that keep their zoom factor in sync.

drawable :

a GimpDrawable

model :

a GimpZoomModel

Returns :

a new GimpZoomPreview.

Since GIMP 2.4


gimp_zoom_preview_get_source ()

guchar *            gimp_zoom_preview_get_source        (GimpZoomPreview *preview,
                                                         gint *width,
                                                         gint *height,
                                                         gint *bpp);

Returns the scaled image data of the part of the drawable the GimpZoomPreview is currently showing, as a newly allocated array of guchar. This function also allow to get the current width, height and bpp of the GimpZoomPreview.

preview :

a GimpZoomPreview widget

width :

a pointer to an int where the current width of the zoom widget will be put.

height :

a pointer to an int where the current width of the zoom widget will be put.

bpp :

return location for the number of bytes per pixel

Returns :

newly allocated data that should be released using g_free() when it is not any longer needed

Since GIMP 2.4


gimp_zoom_preview_get_drawable ()

GimpDrawable *      gimp_zoom_preview_get_drawable      (GimpZoomPreview *preview);

Returns the GimpDrawable the GimpZoomPreview is attached to.

preview :

a GimpZoomPreview widget

Returns :

the GimpDrawable that was passed to gimp_zoom_preview_new().

Since GIMP 2.4


gimp_zoom_preview_get_factor ()

gdouble             gimp_zoom_preview_get_factor        (GimpZoomPreview *preview);

Returns the zoom factor the preview is currently using.

preview :

a GimpZoomPreview widget

Returns :

the current zoom factor

Since GIMP 2.4


gimp_zoom_preview_get_model ()

GimpZoomModel *     gimp_zoom_preview_get_model         (GimpZoomPreview *preview);

Returns the GimpZoomModel the preview is using.

preview :

a GimpZoomPreview widget

Returns :

a pointer to the GimpZoomModel owned by the preview

Since GIMP 2.4

Property Details

The "drawable" property

  "drawable"                 gpointer              : Read / Write / Construct Only

The drawable the GimpZoomPreview is attached to.

Since GIMP 2.4


The "model" property

  "model"                    GimpZoomModel*        : Read / Write / Construct Only

The GimpZoomModel used by this GimpZoomPreview.

Since GIMP 2.4