gdkPixbufRenderToDrawable: gdkPixbufRenderToDrawable

Description

Renders a rectangular portion of a pixbuf to a drawable while using the specified GC. This is done using GdkRGB, so the specified drawable must have the GdkRGB visual and colormap. Note that this function will ignore the opacity information for images with an alpha channel; the GC must already have the clipping mask set if you want transparent regions to show through. WARNING: gdk_pixbuf_render_to_drawable is deprecated and should not be used in newly-written code. This function is obsolete. Use gdkDrawPixbuf instead.

Usage

gdkPixbufRenderToDrawable(object, drawable, gc, src.x = 0, src.y = 0, dest.x, dest.y, width = -1, height = -1, dither = "GDK_RGB_DITHER_NORMAL", x.dither = 0, y.dither = 0)

Arguments

object

[GdkPixbuf] A pixbuf.

drawable

[GdkDrawable] Destination drawable.

gc

[GdkGC] GC used for rendering.

src.x

[integer] Source X coordinate within pixbuf.

src.y

[integer] Source Y coordinate 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

For an explanation of dither offsets, see the GdkRGB documentation. In brief, the dither offset is important when re-rendering partial regions of an image to a rendered version of the full image, or for when the offsets to a base position change, as in scrolling. The dither matrix has to be shifted for consistent visual results. If you do not have any of these cases, the dither offsets can be both zero.