eog-image.h

#ifndef _EOG_IMAGE_H_
#define _EOG_IMAGE_H_

#include <glib-object.h>
#include <libgnomevfs/gnome-vfs-uri.h>
#include <libgnomevfs/gnome-vfs-file-size.h>
#include <libgnomeprint/gnome-print.h>
#include <gdk-pixbuf/gdk-pixbuf.h>
#include "eog-transform.h"
#include "eog-image-save-info.h"
#include "eog-job.h"

#ifdef HAVE_LCMS
#include <lcms.h>
#endif

G_BEGIN_DECLS

#define EOG_TYPE_IMAGE          (eog_image_get_type ())
#define EOG_IMAGE(o)            (G_TYPE_CHECK_INSTANCE_CAST ((o), EOG_TYPE_IMAGE, EogImage))
#define EOG_IMAGE_CLASS(k)      (G_TYPE_CHECK_CLASS_CAST((k), EOG_TYPE_IMAGE, EogImageClass))
#define EOG_IS_IMAGE(o)         (G_TYPE_CHECK_INSTANCE_TYPE ((o), EOG_TYPE_IMAGE))
#define EOG_IS_IMAGE_CLASS(k)   (G_TYPE_CHECK_CLASS_TYPE ((k), EOG_TYPE_IMAGE))
#define EOG_IMAGE_GET_CLASS(o)  (G_TYPE_INSTANCE_GET_CLASS ((o), EOG_TYPE_IMAGE, EogImageClass))

typedef struct _EogImage EogImage;
typedef struct _EogImageClass EogImageClass;
typedef struct _EogImagePrivate EogImagePrivate;

typedef enum {
      EOG_IMAGE_DATA_IMAGE       =  1 << 0,
      EOG_IMAGE_DATA_DIMENSION   =  1 << 1,
      EOG_IMAGE_DATA_EXIF        =  1 << 2
} EogImageData;

#define EOG_IMAGE_DATA_ALL  (EOG_IMAGE_DATA_IMAGE | EOG_IMAGE_DATA_DIMENSION | EOG_IMAGE_DATA_EXIF)

typedef enum {
      EOG_IMAGE_ERROR_SAVE_NOT_LOCAL,
      EOG_IMAGE_ERROR_NOT_LOADED,
      EOG_IMAGE_ERROR_VFS,
      EOG_IMAGE_ERROR_FILE_EXISTS,
      EOG_IMAGE_ERROR_TMP_FILE_FAILED,
      EOG_IMAGE_ERROR_GENERIC,
      EOG_IMAGE_ERROR_UNKNOWN
} EogImageError;

#define EOG_IMAGE_ERROR eog_image_error_quark ()

struct _EogImage {
      GObject parent;

      EogImagePrivate *priv;
};

struct _EogImageClass {
      GObjectClass parent_klass;

      /* signals */
      void (* loading_size_prepared) (EogImage *img, int width, int height);
      void (* loading_update) (EogImage *img, int x, int y, int width, int height);
      void (* loading_finished) (EogImage *img);
      void (* loading_failed) (EogImage *img, const char* message);
      void (* loading_cancelled) (EogImage *img);
      void (* progress) (EogImage *img, float progress);
      
      void (* thumbnail_finished) (EogImage *img);
      void (* thumbnail_failed) (EogImage *img);
      void (* thumbnail_cancelled) (EogImage *img);

      void (* image_changed) (EogImage *img);
};

GType               eog_image_get_type                       (void) G_GNUC_CONST;
GQuark              eog_image_error_quark                    (void);

/* loading API */
EogImage*           eog_image_new                            (const char *txt_uri);
EogImage*           eog_image_new_uri                        (GnomeVFSURI *uri);
gboolean            eog_image_load                           (EogImage *img, 
                                                guint data2read, 
                                                EogJob *job,
                                                GError **error);
gboolean            eog_image_has_data                       (EogImage *img, guint req_data);


void                eog_image_set_thumbnail                  (EogImage *img, GdkPixbuf *pixbuf);
void                eog_image_cancel_load                    (EogImage *img);
EogImage*           eog_image_data_ref                       (EogImage *img);
EogImage*           eog_image_data_unref                     (EogImage *img);
gboolean            eog_image_is_loaded                      (EogImage *img);

/* saving API */
gboolean            eog_image_save                            (EogImage *img, 
                                                 GnomeVFSURI *uri,
                                                 GdkPixbufFormat *format,
                                                 GError **error);
gboolean            eog_image_save_as_by_info                 (EogImage *img, 
                                                 EogImageSaveInfo *source, 
                                                 EogImageSaveInfo *target, 
                                                 EogJob *job,
                                                 GError **error);
gboolean            eog_image_save_by_info                    (EogImage *img, 
                                                 EogImageSaveInfo *source, 
                                                 EogJob *job,
                                                 GError **error);

/* query API */
gboolean            eog_image_is_animation                    (EogImage *img);
GdkPixbuf*          eog_image_get_pixbuf                      (EogImage *img);
GdkPixbuf*          eog_image_get_pixbuf_thumbnail            (EogImage *img);
void                eog_image_get_size                        (EogImage *img, int *width, int *height);
GnomeVFSFileSize    eog_image_get_bytes                       (EogImage *img);
gboolean            eog_image_is_modified                     (EogImage *img);
void                eog_image_modified                        (EogImage *img);
gchar*              eog_image_get_caption                     (EogImage *img);
const gchar*        eog_image_get_collate_key                 (EogImage *img);
gpointer            eog_image_get_exif_information            (EogImage *img);
GnomeVFSURI*        eog_image_get_uri                         (EogImage *img);
gchar*              eog_image_get_uri_for_display             (EogImage *img);
gboolean            eog_image_has_metadata                    (EogImage *img);

#ifdef HAVE_LCMS
cmsHPROFILE eog_image_get_profile (EogImage *img);
void eog_image_apply_display_profile (EogImage *img, cmsHPROFILE profile);
#endif

/* modification API */
void                eog_image_transform                       (EogImage *img, EogTransform *trans, EogJob *job);
void                eog_image_undo                            (EogImage *img);


/* print API */
void               eog_image_print                            (EogImage *img, GnomePrintContext *pc, gdouble width, gdouble height);

G_END_DECLS

#endif /* _IMAGE_H_ */