[LIBART] Re: proposed librsvg API change.

[Ramiro Estrugo <ramiro fateware com>]

I think it would be a big improvement.

Im personally not doing any RSVG work, and I dont 
think Raph is either.

-re

Jonathan Blandford wrote:
> 
> Hi,
> 
> I'm interested in improving librsvg.  In particular, the current API is
> pretty limitted.  You need to give it a FILE, which precludes loading
> one from memory, from gnome-vfs, etc.  Additionally, there is no way to
> know the zoom factor to pass in if you don't know the size of the file
> ahead of time.  There's also no error handling.
> 
> I have a proposal for an alternate API here.  I'm probably going to code
> it tonight.  Does anyone mind if I commit it when it works?
> 
> Thanks,
> -Jonathan
> 
> --------------------
> 
> #ifndef RSVG_H
> #define RSVG_H
> 
> G_BEGIN_DECLS
> 
> #include <stdio.h>
> #include <gdk-pixbuf/gdk-pixbuf.h>
> 
> typedef enum {
>         RSVG_ERROR_FAILED
> } RsvgError;
> 
> #define RSVG_ERROR (rsvg_error_quark ())
> GQuark rsvg_error_quark (void) G_GNUC_CONST;
> 
> typedef struct RsvgHandle RsvgHandle;
> 
> typedef void (* RsvgSizeFunc) (gint *width,
>                                gint *height);
> 
> RsvgHandle *rsvg_handle_new               (void);
> void        rsvg_handle_set_fonts_dir     (RsvgHandle      *handle,
>                                            const char      *fonts_dir);
> void        rsvg_handle_set_size_callback (RsvgHandle      *handle,
>                                            RsvgSizeFunc     func,
>                                            gpointer         data,
>                                            GDestroyNotify   destroy);
> gboolean    rsvg_handle_write             (RsvgHandle      *handle,
>                                            const guchar    *buf,
>                                            gsize            count,
>                                            GError         **error);
> gboolean    rsvg_handle_close             (RsvgHandle      *handle,
>                                            GError         **close);
> GdkPixbuf  *rsvg_handle_get_pixbuf        (RsvgHandle      *handle,
>                                            GError         **errror);
> void        rsvg_handle_get_size          (RsvgHandle      *handle,
>                                            gint            *width,
>                                            gint            *height);
> gboolean    rsvg_handle_destroy           (RsvgHandle      *handle);
> 
> /* convenience API */
> GdkPixbuf  *rsvg_pixbuf_from_file_at_zoom (gchar           *file_name,
>                                            double           x_zoom,
>                                            double           y_zoom);
> GdkPixbuf  *rsvg_pixbuf_from_file_at_size (gchar           *file_name,
>                                            gint             width,
>                                            gint             height);
> 
> G_END_DECLS
> 
> #endif