Handle.getPixbufSub

Creates a gdkpixbuf.pixbuf.Pixbuf the same size as the entire SVG loaded into handle, but only renders the sub-element that has the specified id (and all its sub-sub-elements recursively). If id is NULL, this function renders the whole SVG.

This function depends on the rsvg.handle.Handle's dots-per-inch value (DPI) to compute the "natural size" of the document in pixels, so you should call rsvg.handle.Handle.setDpi beforehand.

If you need to render an image which is only big enough to fit a particular sub-element of the SVG, consider using rsvg.handle.Handle.renderElement.

Element IDs should look like an URL fragment identifier; for example, pass #foo (hash foo) to get the geometry of the element that has an id="foo" attribute.

API ordering: This function must be called on a fully-loaded handle. See the section "API ordering" for details.

class Handle
getPixbufSub
(
string id = null
)

Parameters

id string

An element's id within the SVG, starting with "#" (a single hash character), for example, #layer1. This notation corresponds to a URL's fragment ID. Alternatively, pass NULL to use the whole SVG.

Return Value

Type: gdkpixbuf.pixbuf.Pixbuf

a pixbuf, or NULL if an error occurs during rendering.