enum RsvgError

typedef enum {
	RSVG_ERROR_FAILED
} RsvgError;

RSVG_ERROR

#define RSVG_ERROR (rsvg_error_quark ())

rsvg_error_quark ()

GQuark      rsvg_error_quark                (void);

The error domain for RSVG

rsvg_init ()

void        rsvg_init                       (void);

Initializes librsvg

Since 2.9

rsvg_term ()

void        rsvg_term                       (void);

De-initializes librsvg

Since 2.9

rsvg_set_default_dpi ()

void        rsvg_set_default_dpi            (double dpi);

Sets the DPI for the all future outgoing pixbufs. Common values are 75, 90, and 300 DPI. Passing a number <= 0 to dpi will reset the DPI to whatever the default value happens to be.

Since 2.8

rsvg_set_default_dpi_x_y ()

void        rsvg_set_default_dpi_x_y        (double dpi_x,
                                             double dpi_y);

Sets the DPI for the all future outgoing pixbufs. Common values are 75, 90, and 300 DPI. Passing a number <= 0 to dpi will reset the DPI to whatever the default value happens to be.

Since 2.8

rsvg_handle_new ()

RsvgHandle* rsvg_handle_new                 (void);

Returns a new rsvg handle. Must be freed with g_object_unref. This handle can be used for dynamically loading an image. You need to feed it data using rsvg_handle_write, then call rsvg_handle_close when done. Afterwords, you can render it using Cairo or get a GdkPixbuf from it. When finished, free with g_object_unref(). No more than one image can be loaded with one handle.

rsvg_handle_free ()

void        rsvg_handle_free                (RsvgHandle *handle);

Frees handle.

rsvg_handle_set_dpi ()

void        rsvg_handle_set_dpi             (RsvgHandle *handle,
                                             double dpi);

Sets the DPI for the outgoing pixbuf. Common values are 75, 90, and 300 DPI. Passing a number <= 0 to dpi will reset the DPI to whatever the default value happens to be.

Since 2.8

rsvg_handle_set_dpi_x_y ()

void        rsvg_handle_set_dpi_x_y         (RsvgHandle *handle,
                                             double dpi_x,
                                             double dpi_y);

Sets the DPI for the outgoing pixbuf. Common values are 75, 90, and 300 DPI. Passing a number <= 0 to dpi_x or dpi_y will reset the DPI to whatever the default value happens to be.

Since 2.8

rsvg_handle_write ()

gboolean    rsvg_handle_write               (RsvgHandle *handle,
                                             const guchar *buf,
                                             gsize count,
                                             GError **error);

Loads the next count bytes of the image. This will return TRUE if the data was loaded successful, and FALSE if an error occurred. In the latter case, the loader will be closed, and will not accept further writes. If FALSE is returned, error will be set to an error from the RSVG_ERROR domain.

rsvg_handle_close ()

gboolean    rsvg_handle_close               (RsvgHandle *handle,
                                             GError **error);

Closes handle, to indicate that loading the image is complete. This will return TRUE if the loader closed successfully. Note that handle isn't freed until g_object_unref is called.

rsvg_handle_new_from_data ()

RsvgHandle* rsvg_handle_new_from_data       (const guint8 *data,
                                             gsize data_len,
                                             GError **error);

Loads the SVG specified by data.

Since 2.14

rsvg_handle_new_from_file ()

RsvgHandle* rsvg_handle_new_from_file       (const gchar *file_name,
                                             GError **error);

Loads the SVG specified by file_name.

Since 2.14

RsvgDimensionData

typedef struct {
	/**
	 * SVG's width, in pixels
	 */
	int width;

	/**
	 * SVG's height, in pixels
	 */
	int height;

	/**
	 * em
	 */
	gdouble em;

	/**
	 * ex
	 */
	gdouble ex;
} RsvgDimensionData;

RsvgSizeFunc ()

void        (*RsvgSizeFunc)                 (gint *width,
                                             gint *height,
                                             gpointer user_data);

Function to let a user of the library specify the SVG's dimensions width: the ouput width the SVG should be height: the output height the SVG should be user_data: user data

rsvg_handle_set_size_callback ()

void        rsvg_handle_set_size_callback   (RsvgHandle *handle,
                                             RsvgSizeFunc size_func,
                                             gpointer user_data,
                                             GDestroyNotify user_data_destroy);

Sets the sizing function for the handle. This function is called right after the size of the image has been loaded. The size of the image is passed in to the function, which may then modify these values to set the real size of the generated pixbuf. If the image has no associated size, then the size arguments are set to -1.

rsvg_handle_get_base_uri ()

const char* rsvg_handle_get_base_uri        (RsvgHandle *handle);

Gets the base uri for this RsvgHandle.

Since 2.9 (really present in 2.8 as well)

rsvg_handle_set_base_uri ()

void        rsvg_handle_set_base_uri        (RsvgHandle *handle,
                                             const char *base_uri);

Set the base URI for this SVG. This can only be called before rsvg_handle_write() has been called.

Since 2.9

rsvg_handle_get_title ()

const char* rsvg_handle_get_title           (RsvgHandle *handle);

Returns the SVG's title in UTF-8 or NULL. You must make a copy of this title if you wish to use it after handle has been freed.

Since 2.4

rsvg_handle_get_desc ()

const char* rsvg_handle_get_desc            (RsvgHandle *handle);

Returns the SVG's description in UTF-8 or NULL. You must make a copy of this description if you wish to use it after handle has been freed.

Since 2.4

rsvg_handle_get_dimensions ()

void        rsvg_handle_get_dimensions      (RsvgHandle *handle,
                                             RsvgDimensionData *dimension_data);

Get the SVG's size. Do not call from within the size_func callback, because an infinite loop will occur.

Since 2.14