Constructor

RsvgHandlenew

Declaration [src]

RsvgHandle*
rsvg_handle_new (
  void
)

Description [src]

Returns a new rsvg handle. Must be freed with g_object_unref(). This handle can be used to load an image.

The preferred way of loading SVG data into the returned RsvgHandle is with rsvg_handle_read_stream_sync().

The deprecated way of loading SVG data is with rsvg_handle_write() and rsvg_handle_close(); note that these require buffering the entire file internally, and for this reason it is better to use the stream functions: rsvg_handle_new_from_stream_sync(), rsvg_handle_read_stream_sync(), or rsvg_handle_new_from_gfile_sync().

After loading the RsvgHandle with data, you can render it using Cairo or get a GdkPixbuf from it. When finished, free the handle with g_object_unref(). No more than one image can be loaded with one handle.

Note that this function creates an RsvgHandle with no flags set. If you require any of RsvgHandleFlags to be set, use any of rsvg_handle_new_with_flags(), rsvg_handle_new_from_stream_sync(), or rsvg_handle_new_from_gfile_sync().

Return value

Type: RsvgHandle

A new RsvgHandle with no flags set.

The caller of the function takes ownership of the data, and is responsible for freeing it.