gdkDrawPixbuf: gdkDrawPixbuf

Description

Renders a rectangular portion of a pixbuf to a drawable. The destination drawable must have a colormap. All windows have a colormap, however, pixmaps only have colormap by default if they were created with a non-NULL window argument. Otherwise a colormap must be set on them with gdkDrawableSetColormap.

Usage

gdkDrawPixbuf(object, gc = NULL, pixbuf, src.x, src.y, dest.x, dest.y, width = -1, height = -1, dither = "GDK_RGB_DITHER_NORMAL", x.dither = 0, y.dither = 0)

Arguments

object

[GdkDrawable] Destination drawable.

[GdkGC] a GdkGC, used for clipping, or NULL

pixbuf

[GdkPixbuf] a GdkPixbuf

src.x

[integer] Source X coordinate within pixbuf.

src.y

[integer] Source Y coordinates within pixbuf.

dest.x

[integer] Destination X coordinate within drawable.

dest.y

[integer] Destination Y coordinate within drawable.

width

[integer] Width of region to render, in pixels, or -1 to use pixbuf width.

height

[integer] Height of region to render, in pixels, or -1 to use pixbuf height.

dither

[GdkRgbDither] Dithering mode for GdkRGB.

x.dither

[integer] X offset for dither.

y.dither

[integer] Y offset for dither.

Details

On older X servers, rendering pixbufs with an alpha channel involves round trips to the X server, and may be somewhat slow. The clip mask of gc is ignored, but clip rectangles and clip regions work fine. If GDK is built with the Sun mediaLib library, the gdk_draw_pixbuf function is accelerated using mediaLib, which provides hardware acceleration on Intel, AMD, and Sparc chipsets. If desired, mediaLib support can be turned off by setting the GDK_DISABLE_MEDIALIB environment variable.

Since 2.2