manpagez: man pages & more
html files: goocanvas
Home | html | info | man

GooCanvasImageModel

GooCanvasImageModel — a model for image items.

Synopsis

                    GooCanvasImageModel;
GooCanvasItemModel* goo_canvas_image_model_new          (GooCanvasItemModel *parent,
                                                         GdkPixbuf *pixbuf,
                                                         gdouble x,
                                                         gdouble y,
                                                         ...);

Object Hierarchy

  GObject
   +----GooCanvasItemModelSimple
         +----GooCanvasImageModel

Implemented Interfaces

GooCanvasImageModel implements GooCanvasItemModel.

Properties

  "alpha"                    gdouble               : Read / Write
  "height"                   gdouble               : Read / Write
  "pattern"                  GooCairoPattern*      : Read / Write
  "pixbuf"                   GdkPixbuf*            : Write
  "scale-to-fit"             gboolean              : Read / Write
  "width"                    gdouble               : Read / Write
  "x"                        gdouble               : Read / Write
  "y"                        gdouble               : Read / Write

Description

GooCanvasImageModel represent a model for image items.

It is a subclass of GooCanvasItemModelSimple and so inherits all of the style properties such as "operator" and "pointer-events".

It also implements the GooCanvasItemModel interface, so you can use the GooCanvasItemModel functions such as goo_canvas_item_model_raise() and goo_canvas_item_model_rotate().

To create a GooCanvasImageModel use goo_canvas_image_model_new().

To get or set the properties of an existing GooCanvasImageModel, use g_object_get() and g_object_set().

To respond to events such as mouse clicks on the image you must connect to the signal handlers of the corresponding GooCanvasImage objects. (See goo_canvas_get_item() and "item-created".)

Details

GooCanvasImageModel

typedef struct _GooCanvasImageModel GooCanvasImageModel;

The GooCanvasImageModel struct contains private data only.


goo_canvas_image_model_new ()

GooCanvasItemModel* goo_canvas_image_model_new          (GooCanvasItemModel *parent,
                                                         GdkPixbuf *pixbuf,
                                                         gdouble x,
                                                         gdouble y,
                                                         ...);

Creates a new image model.

parent :

the parent model, or NULL. If a parent is specified, it will assume ownership of the item, and the item will automatically be freed when it is removed from the parent. Otherwise call g_object_unref() to free it.

pixbuf :

the GdkPixbuf containing the image data, or NULL.

x :

the x coordinate of the image.

y :

the y coordinate of the image.

... :

optional pairs of property names and values, and a terminating NULL.

Returns :

a new image model.

Here's an example showing how to create an image at (100.0, 100.0), using the given pixbuf at its natural width and height:

1
2
GooCanvasItemModel *image = goo_canvas_image_model_new (mygroup, pixbuf, 100.0, 100.0,
                                                        NULL);

Property Details

The "alpha" property

  "alpha"                    gdouble               : Read / Write

The opacity of the image, 0.0 is fully transparent, and 1.0 is opaque.

Allowed values: [0,1]

Default value: 1


The "height" property

  "height"                   gdouble               : Read / Write

The height of the image.

Allowed values: >= 0

Default value: 0


The "pattern" property

  "pattern"                  GooCairoPattern*      : Read / Write

The cairo pattern to paint.


The "pixbuf" property

  "pixbuf"                   GdkPixbuf*            : Write

The GdkPixbuf to display.


The "scale-to-fit" property

  "scale-to-fit"             gboolean              : Read / Write

If the image is scaled to fit the width and height settings.

Default value: FALSE


The "width" property

  "width"                    gdouble               : Read / Write

The width of the image.

Allowed values: >= 0

Default value: 0


The "x" property

  "x"                        gdouble               : Read / Write

The x coordinate of the image.

Default value: 0


The "y" property

  "y"                        gdouble               : Read / Write

The y coordinate of the image.

Default value: 0

© manpagez.com 2000-2017
Individual documents may contain additional copyright information.