[libdocument] Add annotations interface

5 files changed, 679 insertions, 0 deletions

diff --git a/libdocument/Makefile.am b/libdocument/Makefile.am
index aa77cca..e6ccb51 100644
--- a/libdocument/Makefile.am
+++ b/libdocument/Makefile.am
@@ -5,10 +5,12 @@ NOINST_H_FILES =				\
 	ev-module.h
 
 INST_H_FILES = 					\
+	ev-annotation.h				\
 	ev-async-renderer.h			\
 	ev-attachment.h				\
 	ev-backends-manager.h			\
 	ev-document-factory.h			\
+	ev-document-annotations.h		\
 	ev-document-find.h			\
 	ev-document-fonts.h			\
 	ev-document-forms.h			\
@@ -41,6 +43,7 @@ headerdir = $(includedir)/evince/$(EV_API_VERSION)/libdocument
 header_DATA = $(INST_H_FILES)
 
 libevdocument_la_SOURCES=			\
+	ev-annotation.c				\
 	ev-async-renderer.c			\
 	ev-attachment.c				\
 	ev-backends-manager.c			\
@@ -51,6 +54,7 @@ libevdocument_la_SOURCES=			\
 	ev-image.c				\
 	ev-init.c				\
 	ev-document.c				\
+	ev-document-annotations.c		\
 	ev-document-factory.c			\
 	ev-document-thumbnails.c		\
 	ev-document-fonts.c                     \
diff --git a/libdocument/ev-annotation.c b/libdocument/ev-annotation.c
new file mode 100644
index 0000000..3245593
--- /dev/null
+++ b/libdocument/ev-annotation.c
@@ -0,0 +1,420 @@
+/* ev-annotation.c
+ *  this file is part of evince, a gnome document viewer
+ *
+ * Copyright (C) 2009 Carlos Garcia Campos <carlosgc@gnome.org>
+ * Copyright (C) 2007 Iñigo Martinez <inigomartinez@gmail.com>
+ *
+ * Evince is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * Evince 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
+ * General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
+ */
+
+#include "config.h"
+
+#include "ev-annotation.h"
+
+
+static void ev_annotation_markup_iface_base_init (EvAnnotationMarkupIface *iface);
+static void ev_annotation_text_markup_iface_init (EvAnnotationMarkupIface *iface);
+
+enum {
+	PROP_0,
+	PROP_LABEL,
+	PROP_OPACITY,
+	PROP_RECTANGLE,
+	PROP_IS_OPEN
+};
+
+G_DEFINE_ABSTRACT_TYPE (EvAnnotation, ev_annotation, G_TYPE_OBJECT)
+GType
+ev_annotation_markup_get_type (void)
+{
+	static volatile gsize g_define_type_id__volatile = 0;
+
+	if (g_once_init_enter (&g_define_type_id__volatile)) {
+		GType g_define_type_id;
+		const GTypeInfo our_info = {
+			sizeof (EvAnnotationMarkupIface),
+			(GBaseInitFunc) ev_annotation_markup_iface_base_init,
+			NULL,
+		};
+
+		g_define_type_id = g_type_register_static (G_TYPE_INTERFACE,
+							   "EvAnnotationMarkup",
+							   &our_info, (GTypeFlags)0);
+		g_type_interface_add_prerequisite (g_define_type_id, EV_TYPE_ANNOTATION);
+
+		g_once_init_leave (&g_define_type_id__volatile, g_define_type_id);
+	}
+
+	return g_define_type_id__volatile;
+}
+
+G_DEFINE_TYPE_WITH_CODE (EvAnnotationText, ev_annotation_text, EV_TYPE_ANNOTATION,
+	 {
+		 G_IMPLEMENT_INTERFACE (EV_TYPE_ANNOTATION_MARKUP,
+					ev_annotation_text_markup_iface_init);
+	 });
+
+/* EvAnnotation */
+static void
+ev_annotation_finalize (GObject *object)
+{
+        EvAnnotation *annot = EV_ANNOTATION (object);
+
+	if (annot->page) {
+		g_object_unref (annot->page);
+		annot->page = NULL;
+	}
+
+        if (annot->contents) {
+                g_free (annot->contents);
+                annot->contents = NULL;
+        }
+
+        if (annot->name) {
+                g_free (annot->name);
+                annot->name = NULL;
+        }
+
+        if (annot->modified) {
+                g_free (annot->modified);
+                annot->modified = NULL;
+        }
+
+        G_OBJECT_CLASS (ev_annotation_parent_class)->finalize (object);
+}
+
+static void
+ev_annotation_init (EvAnnotation *annot)
+{
+}
+
+static void
+ev_annotation_class_init (EvAnnotationClass *klass)
+{
+	GObjectClass *g_object_class = G_OBJECT_CLASS (klass);
+
+	g_object_class->finalize = ev_annotation_finalize;
+}
+
+EvAnnotation *
+ev_annotation_text_new (EvPage *page)
+{
+	EvAnnotation *annot;
+
+	annot = EV_ANNOTATION (g_object_new (EV_TYPE_ANNOTATION_TEXT, NULL));
+	annot->page = g_object_ref (page);
+
+	return annot;
+}
+
+/* EvAnnotationMarkup */
+typedef struct {
+	gchar   *label;
+	gdouble  opacity;
+	gboolean is_open;
+	EvRectangle *rectangle;
+} EvAnnotationMarkupProps;
+
+static void
+ev_annotation_markup_iface_base_init (EvAnnotationMarkupIface *iface)
+{
+	static gboolean initialized = FALSE;
+
+	if (!initialized) {
+		g_object_interface_install_property (iface,
+						     g_param_spec_string ("label",
+									  "Label",
+									  "Label of the markup annotation",
+									  NULL,
+									  G_PARAM_READWRITE));
+		g_object_interface_install_property (iface,
+						     g_param_spec_double ("opacity",
+									  "Opacity",
+									  "Opacity of the markup annotation",
+									  0,
+									  G_MAXDOUBLE,
+									  0,
+									  G_PARAM_READWRITE));
+		g_object_interface_install_property (iface,
+						     g_param_spec_boxed ("rectangle",
+									 "Rectangle",
+									 "The Rectangle of the popup associated "
+									 "to the markup annotation",
+									 EV_TYPE_RECTANGLE,
+									 G_PARAM_READWRITE));
+		g_object_interface_install_property (iface,
+						     g_param_spec_boolean ("is_open",
+									   "Is open",
+									   "Whether the popup associated to "
+									   "the markup annotation is open",
+									   FALSE,
+									   G_PARAM_READWRITE));
+		initialized = TRUE;
+	}
+}
+
+static void
+ev_annotation_markup_props_free (EvAnnotationMarkupProps *props)
+{
+	g_free (props->label);
+	ev_rectangle_free (props->rectangle);
+	g_slice_free (EvAnnotationMarkupProps, props);
+}
+
+static EvAnnotationMarkupProps *
+ev_annotation_markup_get_properties (EvAnnotationMarkup *markup)
+{
+	EvAnnotationMarkupProps *props;
+	static GQuark props_key = 0;
+
+	if (!props_key)
+		props_key = g_quark_from_static_string ("ev-annotation-markup-props");
+
+	props = g_object_get_qdata (G_OBJECT (markup), props_key);
+	if (!props) {
+		props = g_slice_new0 (EvAnnotationMarkupProps);
+		g_object_set_qdata_full (G_OBJECT (markup),
+					 props_key, props,
+					 (GDestroyNotify) ev_annotation_markup_props_free);
+	}
+
+	return props;
+}
+
+static void
+ev_annotation_markup_set_property (GObject      *object,
+				   guint         prop_id,
+				   const GValue *value,
+				   GParamSpec   *pspec)
+{
+	EvAnnotationMarkupProps *props;
+
+	props = ev_annotation_markup_get_properties (EV_ANNOTATION_MARKUP (object));
+
+	switch (prop_id) {
+	case PROP_LABEL:
+		g_free (props->label);
+		props->label = g_value_dup_string (value);
+		break;
+	case PROP_OPACITY:
+		props->opacity = g_value_get_double (value);
+		break;
+	case PROP_RECTANGLE:
+		ev_rectangle_free (props->rectangle);
+		props->rectangle = g_value_dup_boxed (value);
+		break;
+	case PROP_IS_OPEN:
+		props->is_open = g_value_get_boolean (value);
+		break;
+	default:
+		G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
+	}
+}
+
+static void
+ev_annotation_markup_get_property (GObject    *object,
+				   guint       prop_id,
+				   GValue     *value,
+				   GParamSpec *pspec)
+{
+	EvAnnotationMarkupProps *props;
+
+	props = ev_annotation_markup_get_properties (EV_ANNOTATION_MARKUP (object));
+
+	switch (prop_id) {
+	case PROP_LABEL:
+		g_value_set_string (value, props->label);
+		break;
+	case PROP_OPACITY:
+		g_value_set_double (value, props->opacity);
+		break;
+	case PROP_RECTANGLE:
+		g_value_set_boxed (value, props->rectangle);
+		break;
+	case PROP_IS_OPEN:
+		g_value_set_boolean (value, props->is_open);
+		break;
+	default:
+		G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
+	}
+}
+
+static void
+ev_annotation_markup_class_install_properties (GObjectClass *klass)
+{
+	klass->set_property = ev_annotation_markup_set_property;
+	klass->get_property = ev_annotation_markup_get_property;
+
+	g_object_class_override_property (klass, PROP_LABEL, "label");
+	g_object_class_override_property (klass, PROP_OPACITY, "opacity");
+	g_object_class_override_property (klass, PROP_RECTANGLE, "rectangle");
+	g_object_class_override_property (klass, PROP_IS_OPEN, "is_open");
+}
+
+gchar *
+ev_annotation_markup_get_label (EvAnnotationMarkup *markup)
+{
+	gchar *retval;
+
+	g_return_val_if_fail (EV_IS_ANNOTATION_MARKUP (markup), NULL);
+
+	g_object_get (G_OBJECT (markup), "label", &retval, NULL);
+
+	return retval;
+}
+
+void
+ev_annotation_markup_set_label (EvAnnotationMarkup *markup,
+				const gchar        *label)
+{
+	g_return_if_fail (EV_IS_ANNOTATION_MARKUP (markup));
+	g_return_if_fail (label != NULL);
+
+	g_object_set (G_OBJECT (markup), "label", label, NULL);
+}
+
+gdouble
+ev_annotation_markup_get_opacity (EvAnnotationMarkup *markup)
+{
+	gdouble retval;
+
+	g_return_val_if_fail (EV_IS_ANNOTATION_MARKUP (markup), 0.0);
+
+	g_object_get (G_OBJECT (markup), "opacity", &retval, NULL);
+
+	return retval;
+}
+
+void
+ev_annotation_markup_set_opacity (EvAnnotationMarkup *markup,
+				  gdouble             opacity)
+{
+	g_return_if_fail (EV_IS_ANNOTATION_MARKUP (markup));
+
+	g_object_set (G_OBJECT (markup), "opacity", opacity, NULL);
+}
+
+void
+ev_annotation_markup_get_rectangle (EvAnnotationMarkup *markup,
+				    EvRectangle        *ev_rect)
+{
+	EvRectangle *r;
+
+	g_return_if_fail (EV_IS_ANNOTATION_MARKUP (markup));
+	g_return_if_fail (ev_rect != NULL);
+
+	g_object_get (G_OBJECT (markup), "rectangle", &r, NULL);
+	*ev_rect = *r;
+}
+
+gboolean
+ev_annotation_markup_get_is_open (EvAnnotationMarkup *markup)
+{
+	gboolean retval;
+
+	g_return_val_if_fail (EV_IS_ANNOTATION_MARKUP (markup), FALSE);
+
+	g_object_get (G_OBJECT (markup), "is_open", &retval, NULL);
+
+	return retval;
+}
+
+void
+ev_annotation_markup_set_is_open (EvAnnotationMarkup *markup,
+				  gboolean            is_open)
+{
+	g_return_if_fail (EV_IS_ANNOTATION_MARKUP (markup));
+
+	g_object_set (G_OBJECT (markup), "is_open", is_open, NULL);
+}
+
+/* EvAnnotationText */
+static void
+ev_annotation_text_init (EvAnnotationText *annot)
+{
+}
+
+static void
+ev_annotation_text_class_init (EvAnnotationTextClass *klass)
+{
+	GObjectClass *g_object_class = G_OBJECT_CLASS (klass);
+
+	ev_annotation_markup_class_install_properties (g_object_class);
+}
+
+static void
+ev_annotation_text_markup_iface_init (EvAnnotationMarkupIface *iface)
+{
+}
+
+/* Annotation Mapping stuff */
+static void
+ev_annotation_mapping_free_foreach (EvAnnotationMapping *mapping)
+{
+	g_object_unref (mapping->annotation);
+	g_free (mapping);
+}
+
+void
+ev_annotation_mapping_free (GList *annotation_mapping)
+{
+	if (!annotation_mapping)
+		return;
+
+	g_list_foreach (annotation_mapping, (GFunc) ev_annotation_mapping_free_foreach, NULL);
+	g_list_free (annotation_mapping);
+}
+
+EvAnnotation *
+ev_annotation_mapping_find (GList   *annotation_mapping,
+			    gdouble  x,
+			    gdouble  y)
+{
+	GList *list;
+
+	for (list = annotation_mapping; list; list = list->next) {
+		EvAnnotationMapping *mapping = list->data;
+
+		if ((x >= mapping->x1) &&
+		    (y >= mapping->y1) &&
+		    (x <= mapping->x2) &&
+		    (y <= mapping->y2)) {
+			return mapping->annotation;
+		}
+	}
+
+	return NULL;
+}
+
+void
+ev_annotation_mapping_get_area (GList        *annotation_mapping,
+				EvAnnotation *annotation,
+				EvRectangle  *area)
+{
+	GList *list;
+
+	for (list = annotation_mapping; list; list = list->next) {
+		EvAnnotationMapping *mapping = list->data;
+
+		if (mapping->annotation == annotation) {
+			area->x1 = mapping->x1;
+			area->y1 = mapping->y1;
+			area->x2 = mapping->x2;
+			area->y2 = mapping->y2;
+
+			break;
+		}
+	}
+}
diff --git a/libdocument/ev-annotation.h b/libdocument/ev-annotation.h
new file mode 100644
index 0000000..47d908d
--- /dev/null
+++ b/libdocument/ev-annotation.h
@@ -0,0 +1,143 @@
+/* ev-annotation.h
+ *  this file is part of evince, a gnome document viewer
+ *
+ * Copyright (C) 2009 Carlos Garcia Campos <carlosgc@gnome.org>
+ * Copyright (C) 2007 Iñigo Martinez <inigomartinez@gmail.com>
+ *
+ * Evince is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * Evince 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
+ * General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
+ */
+
+#ifndef EV_ANNOTATION_H
+#define EV_ANNOTATION_H
+
+#include <glib-object.h>
+
+#include "ev-document.h"
+
+G_BEGIN_DECLS
+
+/* EvAnnotation */
+#define EV_TYPE_ANNOTATION                      (ev_annotation_get_type())
+#define EV_ANNOTATION(object)                   (G_TYPE_CHECK_INSTANCE_CAST((object), EV_TYPE_ANNOTATION, EvAnnotation))
+#define EV_ANNOTATION_CLASS(klass)              (G_TYPE_CHECK_CLASS_CAST((klass), EV_TYPE_ANNOTATION, EvAnnotationClass))
+#define EV_IS_ANNOTATION(object)                (G_TYPE_CHECK_INSTANCE_TYPE((object), EV_TYPE_ANNOTATION))
+#define EV_IS_ANNOTATION_CLASS(klass)           (G_TYPE_CHECK_CLASS_TYPE((klass), EV_TYPE_ANNOTATION))
+#define EV_ANNOTATION_GET_CLASS(object)         (G_TYPE_INSTANCE_GET_CLASS((object), EV_TYPE_ANNOTATION, EvAnnotationClass))
+
+/* EvAnnotationMarkup */
+#define EV_TYPE_ANNOTATION_MARKUP               (ev_annotation_markup_get_type ())
+#define EV_ANNOTATION_MARKUP(o)                 (G_TYPE_CHECK_INSTANCE_CAST ((o), EV_TYPE_ANNOTATION_MARKUP, EvAnnotationMarkup))
+#define EV_ANNOTATION_MARKUP_IFACE(k)           (G_TYPE_CHECK_CLASS_CAST((k), EV_TYPE_ANNOTATION_MARKUP, EvAnnotationMarkupIface))
+#define EV_IS_ANNOTATION_MARKUP(o)              (G_TYPE_CHECK_INSTANCE_TYPE ((o), EV_TYPE_ANNOTATION_MARKUP))
+#define EV_IS_ANNOTATION_MARKUP_IFACE(k)        (G_TYPE_CHECK_CLASS_TYPE ((k), EV_TYPE_ANNOTATION_MARKUP))
+#define EV_ANNOTATION_MARKUP_GET_IFACE(inst)    (G_TYPE_INSTANCE_GET_INTERFACE ((inst), EV_TYPE_ANNOTATION_MARKUP, EvAnnotationMarkupIface))
+
+/* EvAnnotationText */
+#define EV_TYPE_ANNOTATION_TEXT                 (ev_annotation_text_get_type())
+#define EV_ANNOTATION_TEXT(object)              (G_TYPE_CHECK_INSTANCE_CAST((object), EV_TYPE_ANNOTATION_TEXT, EvAnnotationText))
+#define EV_ANNOTATION_TEXT_CLASS(klass)         (G_TYPE_CHECK_CLASS_CAST((klass), EV_TYPE_ANNOTATION_TEXT, EvAnnotationTextClass))
+#define EV_IS_ANNOTATION_TEXT(object)           (G_TYPE_CHECK_INSTANCE_TYPE((object), EV_TYPE_ANNOTATION_TEXT))
+#define EV_IS_ANNOTATION_TEXT_CLASS(klass)      (G_TYPE_CHECK_CLASS_TYPE((klass), EV_TYPE_ANNOTATION_TEXT))
+#define EV_ANNOTATION_TEXT_GET_CLASS(object)    (G_TYPE_INSTANCE_GET_CLASS((object), EV_TYPE_ANNOTATION_TEXT, EvAnnotationTextClass))
+
+typedef struct _EvAnnotation             EvAnnotation;
+typedef struct _EvAnnotationClass        EvAnnotationClass;
+
+typedef struct _EvAnnotationMarkup       EvAnnotationMarkup;
+typedef struct _EvAnnotationMarkupIface  EvAnnotationMarkupIface;
+
+typedef struct _EvAnnotationText         EvAnnotationText;
+typedef struct _EvAnnotationTextClass    EvAnnotationTextClass;
+
+struct _EvAnnotation
+{
+	GObject parent;
+
+	EvPage  *page;
+	gboolean changed;
+
+	gchar   *contents;
+	gchar   *name;
+	gchar   *modified;
+	GdkColor color;
+
+};
+
+struct _EvAnnotationClass
+{
+	GObjectClass parent_class;
+};
+
+struct _EvAnnotationMarkupIface
+{
+	GTypeInterface base_iface;
+};
+
+struct _EvAnnotationText
+{
+	EvAnnotation parent;
+
+	gboolean is_open : 1;
+};
+
+struct _EvAnnotationTextClass
+{
+	EvAnnotationClass parent_class;
+};
+
+/* EvAnnotation */
+GType         ev_annotation_get_type             (void) G_GNUC_CONST;
+
+/* EvAnnotationMarkup */
+GType         ev_annotation_markup_get_type      (void) G_GNUC_CONST;
+gchar        *ev_annotation_markup_get_label     (EvAnnotationMarkup *markup);
+void          ev_annotation_markup_set_label     (EvAnnotationMarkup *markup,
+						  const gchar        *label);
+gdouble       ev_annotation_markup_get_opacity   (EvAnnotationMarkup *markup);
+void          ev_annotation_markup_set_opacity   (EvAnnotationMarkup *markup,
+						  gdouble             opacity);
+void          ev_annotation_markup_get_rectangle (EvAnnotationMarkup *markup,
+						  EvRectangle        *ev_rect);
+gboolean      ev_annotation_markup_get_is_open   (EvAnnotationMarkup *markup);
+void          ev_annotation_markup_set_is_open   (EvAnnotationMarkup *markup,
+						  gboolean            is_open);
+
+/* EvAnnotationText */
+GType         ev_annotation_text_get_type        (void) G_GNUC_CONST;
+EvAnnotation *ev_annotation_text_new             (EvPage             *page);
+
+
+/* Annotation Mapping stuff */
+typedef struct _EvAnnotationMapping   EvAnnotationMapping;
+struct _EvAnnotationMapping
+{
+	        EvAnnotation *annotation;
+	        gdouble       x1;
+	        gdouble       y1;
+	        gdouble       x2;
+	        gdouble       y2;
+};
+
+void          ev_annotation_mapping_free     (GList       *annotation_mapping);
+EvAnnotation *ev_annotation_mapping_find     (GList       *annotation_mapping,
+					      gdouble       x,
+					      gdouble       y);
+void          ev_annotation_mapping_get_area (GList        *annotation_mapping,
+					      EvAnnotation *annotation,
+					      EvRectangle  *area);
+
+G_END_DECLS
+
+#endif /* EV_ANNOTATION_H */
diff --git a/libdocument/ev-document-annotations.c b/libdocument/ev-document-annotations.c
new file mode 100644
index 0000000..f42ae7d
--- /dev/null
+++ b/libdocument/ev-document-annotations.c
@@ -0,0 +1,48 @@
+/* ev-document-annotations.c
+ *  this file is part of evince, a gnome document viewer
+ *
+ * Copyright (C) 2009 Carlos Garcia Campos <carlosgc@gnome.org>
+ * Copyright (C) 2007 Iñigo Martinez <inigomartinez@gmail.com>
+ *
+ * Evince is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * Evince 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
+ * General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
+ */
+
+#include "ev-document-annotations.h"
+
+EV_DEFINE_INTERFACE (EvDocumentAnnotations, ev_document_annotations, 0)
+
+static void
+ev_document_annotations_class_init (EvDocumentAnnotationsIface *klass)
+{
+}
+
+GList *
+ev_document_annotations_get_annotations (EvDocumentAnnotations *document_annots,
+					 EvPage                *page)
+{
+	EvDocumentAnnotationsIface *iface = EV_DOCUMENT_ANNOTATIONS_GET_IFACE (document_annots);
+
+	return iface->get_annotations (document_annots, page);
+}
+
+void
+ev_document_annotations_annotation_set_contents (EvDocumentAnnotations *document_annots,
+						 EvAnnotation          *annot,
+						 const gchar           *contents)
+{
+	EvDocumentAnnotationsIface *iface = EV_DOCUMENT_ANNOTATIONS_GET_IFACE (document_annots);
+
+	iface->annotation_set_contents (document_annots, annot, contents);
+}
diff --git a/libdocument/ev-document-annotations.h b/libdocument/ev-document-annotations.h
new file mode 100644
index 0000000..3942ecf
--- /dev/null
+++ b/libdocument/ev-document-annotations.h
@@ -0,0 +1,64 @@
+/* ev-document-annotations.h
+ *  this file is part of evince, a gnome document viewer
+ *
+ * Copyright (C) 2007 Iñigo Martinez <inigomartinez@gmail.com>
+ *
+ * Evince is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * Evince 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
+ * General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
+ */
+
+#ifndef EV_DOCUMENT_ANNOTATIONS_H
+#define EV_DOCUMENT_ANNOTATIONS_H
+
+#include <glib-object.h>
+
+#include "ev-document.h"
+#include "ev-annotation.h"
+
+G_BEGIN_DECLS
+
+#define EV_TYPE_DOCUMENT_ANNOTATIONS            (ev_document_annotations_get_type ())
+#define EV_DOCUMENT_ANNOTATIONS(o)              (G_TYPE_CHECK_INSTANCE_CAST ((o), EV_TYPE_DOCUMENT_ANNOTATIONS, EvDocumentAnnotations))
+#define EV_DOCUMENT_ANNOTATIONS_IFACE(k)        (G_TYPE_CHECK_CLASS_CAST((k), EV_TYPE_DOCUMENT_ANNOTATIONS, EvDocumentAnnotationsIface))
+#define EV_IS_DOCUMENT_ANNOTATIONS(o)           (G_TYPE_CHECK_INSTANCE_TYPE ((o), EV_TYPE_DOCUMENT_ANNOTATIONS))
+#define EV_IS_DOCUMENT_ANNOTATIONS_IFACE(k)     (G_TYPE_CHECK_CLASS_TYPE ((k), EV_TYPE_DOCUMENT_ANNOTATIONS))
+#define EV_DOCUMENT_ANNOTATIONS_GET_IFACE(inst) (G_TYPE_INSTANCE_GET_INTERFACE ((inst), EV_TYPE_DOCUMENT_ANNOTATIONS, EvDocumentAnnotationsIface))
+
+typedef struct _EvDocumentAnnotations      EvDocumentAnnotations;
+typedef struct _EvDocumentAnnotationsIface EvDocumentAnnotationsIface;
+
+struct _EvDocumentAnnotationsIface
+{
+	GTypeInterface base_iface;
+
+	/* Methods  */
+	GList *(* get_annotations)         (EvDocumentAnnotations *document_annots,
+					    EvPage                *page);
+	void   (* annotation_set_contents) (EvDocumentAnnotations *document_annots,
+					    EvAnnotation          *annot,
+					    const gchar           *contents);
+};
+
+GType  ev_document_annotations_get_type                (void) G_GNUC_CONST;
+GList *ev_document_annotations_get_annotations         (EvDocumentAnnotations *document_annots,
+							EvPage                *page);
+
+void   ev_document_annotations_annotation_set_contents (EvDocumentAnnotations *document_annots,
+							EvAnnotation          *annot,
+							const gchar           *contents);
+
+G_END_DECLS
+
+#endif /* EV_DOCUMENT_ANNOTATIONS_H */
+