]> Pileus Git - ~andy/gtk/blobdiff - gdk-pixbuf/gdk-pixbuf-io.h
Updated Catalan translation by David Planella
[~andy/gtk] / gdk-pixbuf / gdk-pixbuf-io.h
index 60046b8e7fbb7b98dd7fc71ae8d457c84870add1..b1a162f89c200c1eed0f76b2fd7088f07b5fd646 100644 (file)
@@ -1,5 +1,6 @@
-/* GdkPixbuf library - Io handling.  This is an internal header for gdk-pixbuf.
- * You should never use it unless you are doing developement for gdkpixbuf itself.
+/* GdkPixbuf library - Io handling.  This is an internal header for 
+ * GdkPixbuf. You should never use it unless you are doing development for 
+ * GdkPixbuf itself.
  *
  * Copyright (C) 1999 The Free Software Foundation
  *
  * Boston, MA 02111-1307, USA.
  */
 
+#if defined(GDK_PIXBUF_DISABLE_SINGLE_INCLUDES) && !defined (GDK_PIXBUF_H_INSIDE) && !defined (GDK_PIXBUF_COMPILATION)
+#error "Only <gdk-pixbuf/gdk-pixbuf.h> can be included directly."
+#endif
+
 #ifndef GDK_PIXBUF_IO_H
 #define GDK_PIXBUF_IO_H
 
-#include <gmodule.h>
 #include <stdio.h>
-#include "gdk-pixbuf.h"
-#include "gdk-pixbuf-i18n.h"
+#include <glib.h>
+#include <gmodule.h>
+#include <gdk-pixbuf/gdk-pixbuf-core.h>
+#include <gdk-pixbuf/gdk-pixbuf-animation.h>
 
-#ifdef __cplusplus
-extern "C" {
-#endif
+G_BEGIN_DECLS
+
+typedef struct _GdkPixbufFormat GdkPixbufFormat;
+GSList    *gdk_pixbuf_get_formats            (void);
+gchar     *gdk_pixbuf_format_get_name        (GdkPixbufFormat *format);
+gchar     *gdk_pixbuf_format_get_description (GdkPixbufFormat *format);
+gchar    **gdk_pixbuf_format_get_mime_types  (GdkPixbufFormat *format);
+gchar    **gdk_pixbuf_format_get_extensions  (GdkPixbufFormat *format);
+gboolean   gdk_pixbuf_format_is_writable     (GdkPixbufFormat *format);
+gboolean   gdk_pixbuf_format_is_scalable     (GdkPixbufFormat *format);
+gboolean   gdk_pixbuf_format_is_disabled     (GdkPixbufFormat *format);
+void       gdk_pixbuf_format_set_disabled    (GdkPixbufFormat *format,
+                                             gboolean         disabled);
+gchar     *gdk_pixbuf_format_get_license     (GdkPixbufFormat *format);
+
+GdkPixbufFormat *gdk_pixbuf_get_file_info    (const gchar     *filename,
+                                             gint            *width, 
+                                             gint            *height);
+
+#ifdef GDK_PIXBUF_ENABLE_BACKEND
 
 \f
 
-typedef void (* ModulePreparedNotifyFunc) (GdkPixbuf *pixbuf, gpointer user_data);
-typedef void (* ModuleUpdatedNotifyFunc) (GdkPixbuf *pixbuf,
-                                         guint x, guint y,
-                                         guint width, guint height,
-                                         gpointer user_data);
-/* Needed only for animated images. */
-typedef void (* ModuleFrameDoneNotifyFunc) (GdkPixbufFrame *frame,
-                                           gpointer user_data);
-typedef void (* ModuleAnimationDoneNotifyFunc) (GdkPixbuf *pixbuf,
-                                               gpointer user_data);
+typedef void (* GdkPixbufModuleSizeFunc)           (gint *width, 
+                                                   gint *height, 
+                                                   gpointer user_data);
+
+typedef void (* GdkPixbufModulePreparedFunc) (GdkPixbuf          *pixbuf,
+                                             GdkPixbufAnimation *anim,
+                                             gpointer            user_data);
+typedef void (* GdkPixbufModuleUpdatedFunc)  (GdkPixbuf *pixbuf,
+                                             int        x,
+                                             int        y,
+                                             int        width,
+                                             int        height,
+                                             gpointer   user_data);
+
+typedef struct _GdkPixbufModulePattern GdkPixbufModulePattern;
+struct _GdkPixbufModulePattern {
+       char *prefix;
+       char *mask;
+       int relevance;
+};
 
 typedef struct _GdkPixbufModule GdkPixbufModule;
 struct _GdkPixbufModule {
        char *module_name;
-       gboolean (* format_check) (guchar *buffer, int size);
+       char *module_path;
        GModule *module;
+       GdkPixbufFormat *info;
+       
         GdkPixbuf *(* load) (FILE    *f,
                              GError **error);
         GdkPixbuf *(* load_xpm_data) (const char **data);
 
         /* Incremental loading */
 
-        gpointer (* begin_load) (ModulePreparedNotifyFunc prepare_func,
-                                ModuleUpdatedNotifyFunc update_func,
-                                ModuleFrameDoneNotifyFunc frame_done_func,
-                                ModuleAnimationDoneNotifyFunc anim_done_func,
-                                gpointer user_data,
-                                 GError **error);
-        void (* stop_load)          (gpointer context);
+        gpointer (* begin_load)     (GdkPixbufModuleSizeFunc size_func,
+                                     GdkPixbufModulePreparedFunc prepare_func,
+                                     GdkPixbufModuleUpdatedFunc update_func,
+                                     gpointer user_data,
+                                     GError **error);
+        gboolean (* stop_load)      (gpointer context,
+                                     GError **error);
         gboolean (* load_increment) (gpointer      context,
                                      const guchar *buf,
                                      guint         size,
@@ -77,26 +113,60 @@ struct _GdkPixbufModule {
        GdkPixbufAnimation *(* load_animation) (FILE    *f,
                                                 GError **error);
 
+        /* Saving */
         gboolean (* save) (FILE      *f,
                            GdkPixbuf *pixbuf,
                            gchar    **param_keys,
                            gchar    **param_values,
                            GError   **error);
+
+        gboolean (*save_to_callback) (GdkPixbufSaveFunc save_func,
+                                     gpointer user_data,
+                                     GdkPixbuf *pixbuf,
+                                     gchar **option_keys,
+                                     gchar **option_values,
+                                     GError **error);
+  
+  /*< private >*/
+       void (*_reserved1) (void); 
+       void (*_reserved2) (void); 
+       void (*_reserved3) (void); 
+       void (*_reserved4) (void); 
+       void (*_reserved5) (void); 
+
 };
 
+typedef void (* GdkPixbufModuleFillVtableFunc) (GdkPixbufModule *module);
+typedef void (* GdkPixbufModuleFillInfoFunc) (GdkPixbufFormat *info);
 
-GdkPixbufModule *gdk_pixbuf_get_module (guchar *buffer, guint size,
-                                        const gchar *filename,
-                                        GError **error);
-GdkPixbufModule *gdk_pixbuf_get_named_module (const char *name,
-                                              GError **error);
-gboolean gdk_pixbuf_load_module (GdkPixbufModule *image_module,
-                                 GError **error);
+/*  key/value pairs that can be attached by the pixbuf loader  */
 
-\f
+gboolean gdk_pixbuf_set_option  (GdkPixbuf   *pixbuf,
+                                 const gchar *key,
+                                 const gchar *value);
 
-#ifdef __cplusplus
-}
-#endif
+typedef enum /*< skip >*/
+{
+  GDK_PIXBUF_FORMAT_WRITABLE = 1 << 0,
+  GDK_PIXBUF_FORMAT_SCALABLE = 1 << 1,
+  GDK_PIXBUF_FORMAT_THREADSAFE = 1 << 2
+} GdkPixbufFormatFlags;
 
-#endif
+struct _GdkPixbufFormat {
+  gchar *name;
+  GdkPixbufModulePattern *signature;
+  gchar *domain;
+  gchar *description;
+  gchar **mime_types;
+  gchar **extensions;
+  guint32 flags;
+  gboolean disabled;
+  gchar *license;
+};
+
+
+#endif /* GDK_PIXBUF_ENABLE_BACKEND */
+
+G_END_DECLS
+
+#endif /* GDK_PIXBUF_IO_H */