GooCanvasImage

GooCanvasImage — an image item.

Functions

Properties

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

Types and Values

Object Hierarchy

    GObject
    ╰── GooCanvasItemSimple
        ╰── GooCanvasImage

Implemented Interfaces

GooCanvasImage implements GooCanvasItem.

Description

GooCanvasImage represents an image item.

It is usually necessary to set the "scale-to-fit" property to TRUE to scale the image to fit the given rectangle.

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

It also implements the GooCanvasItem interface, so you can use the GooCanvasItem functions such as goo_canvas_item_raise() and goo_canvas_item_rotate().

To create a GooCanvasImage use goo_canvas_image_new().

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

Functions

goo_canvas_image_new ()

GooCanvasItem *
goo_canvas_image_new (GooCanvasItem *parent,
                      GdkPixbuf *pixbuf,
                      gdouble x,
                      gdouble y,
                      ...);

Creates a new image item.

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
GooCanvasItem *image = goo_canvas_image_new (mygroup, pixbuf, 100.0, 100.0,
                                             NULL);

This example creates an image scaled to a size of 200x200:

1
2
3
4
5
GooCanvasItem *image = goo_canvas_image_new (mygroup, pixbuf, 100.0, 100.0,
                                             "width", 200.0,
                                             "height", 200.0,
                                             "scale-to-fit", TRUE,
                                             NULL);

Parameters

parent

the parent item, 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.

[skip]

pixbuf

the GdkPixbuf containing the image data, or NULL.

[allow-none]

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 item.

[transfer full]

Types and Values

struct GooCanvasImage

struct GooCanvasImage;

The GooCanvasImage struct contains private data only.

Property Details

The “alpha” property

  “alpha”                    gdouble

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

Flags: Read / Write

Allowed values: [0,1]

Default value: 1


The “height” property

  “height”                   gdouble

The height of the image.

Flags: Read / Write

Allowed values: >= 0

Default value: 0


The “pattern” property

  “pattern”                  GooCairoPattern *

The cairo pattern to paint.

Flags: Read / Write


The “pixbuf” property

  “pixbuf”                   GdkPixbuf *

The GdkPixbuf to display.

Flags: Write


The “scale-to-fit” property

  “scale-to-fit”             gboolean

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

Flags: Read / Write

Default value: FALSE


The “width” property

  “width”                    gdouble

The width of the image.

Flags: Read / Write

Allowed values: >= 0

Default value: 0


The “x” property

  “x”                        gdouble

The x coordinate of the image.

Flags: Read / Write

Default value: 0


The “y” property

  “y”                        gdouble

The y coordinate of the image.

Flags: Read / Write

Default value: 0