-/* GdkPixbuf library - Io handling
+/* 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
*
* Michael Fulbright <drmike@redhat.com>
*
* This library is free software; you can redistribute it and/or
- * modify it under the terms of the GNU Library General Public
+ * modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
- * Library General Public License for more details.
+ * Lesser General Public License for more details.
*
- * You should have received a copy of the GNU Library General Public
+ * You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
#ifndef GDK_PIXBUF_IO_H
#define GDK_PIXBUF_IO_H
-#include <gmodule.h>
-#include "gdk-pixbuf.h"
#include <stdio.h>
+#include <glib.h>
+#include <gmodule.h>
+#include <gdk-pixbuf/gdk-pixbuf-core.h>
+#include <gdk-pixbuf/gdk-pixbuf-animation.h>
+
+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 __cplusplus
-extern "C" {
-#pragma }
-#endif
+#ifdef GDK_PIXBUF_ENABLE_BACKEND
\f
-typedef void (* ModulePreparedNotifyFunc) (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;
- GdkPixbuf *(* load) (FILE *f);
- GdkPixbuf *(* load_xpm_data) (const gchar **data);
+ GdkPixbufFormat *info;
+
+ GdkPixbuf *(* load) (FILE *f,
+ GError **error);
+ GdkPixbuf *(* load_xpm_data) (const char **data);
/* Incremental loading */
- gpointer (* begin_load) (ModulePreparedNotifyFunc func, gpointer user_data);
- void (* stop_load) (gpointer context);
- gboolean (* load_increment)(gpointer context, guchar *buf, guint size);
+
+ 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,
+ GError **error);
+
+ /* Animation loading */
+ 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 (gchar *buffer, gint size);
-void gdk_pixbuf_load_module (GdkPixbufModule *image_module);
+/* 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);
+
+typedef enum /*< skip >*/
+{
+ GDK_PIXBUF_FORMAT_WRITABLE = 1 << 0,
+ GDK_PIXBUF_FORMAT_SCALABLE = 1 << 1,
+ GDK_PIXBUF_FORMAT_THREADSAFE = 1 << 2
+} GdkPixbufFormatFlags;
+
+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 */
-#ifdef __cplusplus
-}
-#endif
+G_END_DECLS
-#endif
+#endif /* GDK_PIXBUF_IO_H */