glib/poppler-page.cc - third_party/poppler - Git at Google

 /* poppler.h: glib wrapper for poppler
  * Copyright (C) 2005, Red Hat, Inc.
  *
  * This program 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, or (at your option)
  * any later version.
  *
  * This program 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 <math.h>

 #include <goo/GooList.h>
 #include <splash/SplashBitmap.h>
 #include <GlobalParams.h>
 #include <PDFDoc.h>
 #include <Outline.h>
 #include <ErrorCodes.h>
 #include <UnicodeMap.h>
 #include <GfxState.h>
 #include <SplashOutputDev.h>
 #include <TextOutputDev.h>

 #include "poppler.h"
 #include "poppler-private.h"

 enum
 {
   PROP_0,
   PROP_LABEL
 };

 typedef struct _PopplerPageClass PopplerPageClass;
 struct _PopplerPageClass
 {
   GObjectClass parent_class;
 };

 G_DEFINE_TYPE (PopplerPage, poppler_page, G_TYPE_OBJECT);

 PopplerPage *
 _poppler_page_new (PopplerDocument *document, Page *page, int index)
 {
   PopplerPage *poppler_page;

   g_return_val_if_fail (POPPLER_IS_DOCUMENT (document), NULL);

   poppler_page = (PopplerPage *) g_object_new (POPPLER_TYPE_PAGE, NULL);
   poppler_page->document = document;
   poppler_page->page = page;
   poppler_page->index = index;

   return poppler_page;
 }

 static void
 poppler_page_finalize (GObject *object)
 {
   /* page->page is owned by the document */
 }

 void
 poppler_page_get_size (PopplerPage *page,
 		       double      *width,
 		       double      *height)
 {
   g_return_if_fail (POPPLER_IS_PAGE (page));

   if (width != NULL)
     *width = page->page->getWidth ();
   if (height != NULL)
     *height = page->page->getHeight ();
 }

 int
 poppler_page_get_index (PopplerPage *page)
 {
   g_return_val_if_fail (POPPLER_IS_PAGE (page), 0);

   return page->index;
 }

 /**
  * poppler_page_render_to_pixbuf:
  * @page: the page to render from
  * @src_x: x coordinate of upper left corner
  * @src_y: y coordinate of upper left corner
  * @src_width: width of rectangle to render
  * @src_height: height of rectangle to render
  * @ppp: pixels per point
  * @pixbuf: pixbuf to render into
  * @dest_x: x coordinate of offset into destination
  * @dest_y: y cooridnate of offset into destination
  *
  * First scale the document to match the specified pixels per point,
  * then render the rectangle given by the upper left corner at
  * (src_x, src_y) and src_width and src_height.  The rectangle is
  * rendered into the specified pixmap with the upper left corner
  * placed at (dest_x, dest_y).
  **/
 void
 poppler_page_render_to_pixbuf (PopplerPage *page,
 			       int src_x, int src_y,
 			       int src_width, int src_height,
 			       double scale,
 			       GdkPixbuf *pixbuf,
 			       int dest_x, int dest_y)
 {
   SplashOutputDev *output_dev;
   SplashColor white;
   SplashBitmap *bitmap;
   SplashColorPtr color_ptr;
   SplashRGB8 *src;
   int splash_width, splash_height, splash_rowstride;
   int pixbuf_rowstride, pixbuf_n_channels;
   guchar *pixbuf_data, *dst;
   int x, y;

   g_return_if_fail (POPPLER_IS_PAGE (page));
   g_return_if_fail (scale > 0.0);
   g_return_if_fail (pixbuf != NULL);

   white.rgb8 = splashMakeRGB8 (0xff, 0xff, 0xff);
   output_dev = new SplashOutputDev(splashModeRGB8, gFalse, white);

   output_dev->startDoc(page->document->doc->getXRef ());

   page->page->displaySlice(output_dev, 72.0 * scale, 72.0 * scale,
 			   0, /* Rotate */
 			   gTrue, /* Crop */
 			   src_x, src_y,
 			   src_width, src_height,
 			   NULL, /* links */
 			   page->document->doc->getCatalog ());

   bitmap = output_dev->getBitmap ();
   color_ptr = bitmap->getDataPtr ();

   splash_width = bitmap->getWidth ();
   splash_height = bitmap->getHeight ();
   splash_rowstride = bitmap->getRowSize ();

   pixbuf_data = gdk_pixbuf_get_pixels (pixbuf);
   pixbuf_rowstride = gdk_pixbuf_get_rowstride (pixbuf);
   pixbuf_n_channels = gdk_pixbuf_get_n_channels (pixbuf);

   if (dest_x + splash_width > gdk_pixbuf_get_width (pixbuf))
     splash_width = gdk_pixbuf_get_width (pixbuf) - dest_x;
   if (dest_y + splash_height > gdk_pixbuf_get_height (pixbuf))
     splash_height = gdk_pixbuf_get_height (pixbuf) - dest_y;

   for (y = 0; y < splash_height; y++)
     {
       SplashRGB8 *src;
       SplashRGB8 rgb;

       src = (SplashRGB8 *) (color_ptr.rgb8p + y * splash_rowstride);
       dst = pixbuf_data + (dest_y + y) * pixbuf_rowstride +
 	dest_x * pixbuf_n_channels;
       for (x = 0; x < splash_width; x++)
 	{
 	  dst[0] = splashRGB8R(*src);
 	  dst[1] = splashRGB8G(*src);
 	  dst[2] = splashRGB8B(*src);
 	  dst += pixbuf_n_channels;
 	  src++;
 	}
     }

   delete output_dev;
 }

 static void
 destroy_thumb_data (guchar *pixels, gpointer data)
 {
   gfree (pixels);
 }

 GdkPixbuf *
 poppler_page_get_thumbnail (PopplerPage *page)
 {
   unsigned char *data;
   int width, height, rowstride;

   g_return_val_if_fail (POPPLER_IS_PAGE (page), FALSE);

   if (!page->page->loadThumb (&data, &width, &height, &rowstride))
     return NULL;

   return gdk_pixbuf_new_from_data (data, GDK_COLORSPACE_RGB,
 				   FALSE, 8, width, height, rowstride,
 				   destroy_thumb_data, NULL);
 }

 /**
  * poppler_page_get_thumbnail_size:
  * @page: A #PopplerPage
  * @width: return location for width
  * @height: return location for height
  *
  * Returns %TRUE if @page has a thumbnail associated with it.  It also fills in
  * @width and @height with the width and height of the thumbnail.  The values of
  * width and height are not changed if no appropriate thumbnail exists.
  *
  * Return value: %TRUE, if @page has a thumbnail associated with it.
  **/
 gboolean
 poppler_page_get_thumbnail_size (PopplerPage *page,
 				 int         *width,
 				 int         *height)
 {
   Object thumb;
   Dict *dict;
   gboolean retval = FALSE;

   g_return_val_if_fail (POPPLER_IS_PAGE (page), FALSE);
   g_return_val_if_fail (width != NULL, FALSE);
   g_return_val_if_fail (height != NULL, FALSE);

   page->page->getThumb (&thumb);
   if (thumb.isNull ())
     {
       thumb.free ();
       return FALSE;
     }

   dict = thumb.streamGetDict();

   /* Theoretically, this could succeed and you would still fail when
    * loading the thumb */
   if (dict->lookupInt ("Width", "W", width)  &&
       dict->lookupInt ("Height", "H", height))
     retval = TRUE;

   thumb.free ();

   return retval;
 }

 /**
  * poppler_page_get_text:
  * @page: a #PopplerPage
  * @rect: the rectangle including the text
  *
  * Retrieves the contents of the specified rectangle as text
  *
  * Return value: a pointer to the contents of the rectangle
  *               as a string
  **/
 char *
 poppler_page_get_text (PopplerPage      *page,
 		       PopplerRectangle *rect)
 {
   TextOutputDev *output_dev;
   PDFDoc *doc;
   GooString *sel_text = new GooString;
   PopplerRectangle text_dev_rect;
   double height, y1, y2;
   char *result;

   g_return_val_if_fail (POPPLER_IS_PAGE (page), FALSE);
   g_return_val_if_fail (rect != NULL, NULL);

   output_dev = new TextOutputDev (NULL, gTrue, gFalse, gFalse);
   doc = page->document->doc;

   height = page->page->getHeight ();
   page->page->display(output_dev, 72, 72, 0, gTrue, NULL, doc->getCatalog());

   y1 = height - rect->y2;
   y2 = height - rect->y1;
   sel_text = output_dev->getText (rect->x1, y1, rect->x2, y2);
   result = sel_text->getCString ();

   delete output_dev;

   return result ? g_strdup (result) : NULL;
 }

 /**
  * poppler_page_find_text:
  * @page: a #PopplerPage
  * @text: the text to search for (UTF-8 encoded)
  *
  * A #GList of rectangles for each occurance of the text on the page.
  * The coordinates are in PDF points.
  *
  * Return value: a #GList of PopplerRectangle,
  **/
 GList *
 poppler_page_find_text (PopplerPage *page,
 			const char  *text)
 {
   PopplerRectangle *match;
   TextOutputDev *output_dev;
   PDFDoc *doc;
   GList *matches;
   double xMin, yMin, xMax, yMax;
   gunichar *ucs4;
   glong ucs4_len;
   double height;

   g_return_val_if_fail (POPPLER_IS_PAGE (page), FALSE);
   g_return_val_if_fail (text != NULL, FALSE);

   ucs4 = g_utf8_to_ucs4_fast (text, -1, &ucs4_len);

   output_dev = new TextOutputDev (NULL, gTrue, gFalse, gFalse);
   doc = page->document->doc;

   height = page->page->getHeight ();
   page->page->display (output_dev, 72, 72, 0, gTrue, NULL, doc->getCatalog());

   matches = NULL;
   while (output_dev->findText (ucs4, ucs4_len,
 			       gFalse, gTrue, // startAtTop, stopAtBottom
 			       gTrue, gFalse, // startAtLast, stopAtLast
 			       &xMin, &yMin, &xMax, &yMax))
     {
       match = g_new (PopplerRectangle, 1);
       match->x1 = xMin;
       match->y1 = height - yMax;
       match->x2 = xMax;
       match->y2 = height - yMin;
       matches = g_list_prepend (matches, match);
     }

   delete output_dev;
   g_free (ucs4);

   return g_list_reverse (matches);
 }

 static void
 poppler_page_get_property (GObject *object,
 			   guint prop_id,
 			   GValue *value,
 			   GParamSpec *pspec)
 {
   PopplerPage *page = POPPLER_PAGE (object);
   GooString label;

   switch (prop_id)
     {
     case PROP_LABEL:
       page->document->doc->getCatalog ()->indexToLabel (page->index, &label);
       g_value_set_string (value, label.getCString());
       break;
     }
 }

 static void
 poppler_page_class_init (PopplerPageClass *klass)
 {
   GObjectClass *gobject_class = G_OBJECT_CLASS (klass);
   GParamSpec *pspec;

   gobject_class->finalize = poppler_page_finalize;
   gobject_class->get_property = poppler_page_get_property;

   pspec = g_param_spec_string ("label",
 			       "Page Label",
 			       "The label of the page",
 			       NULL,
 			       G_PARAM_READABLE);
   g_object_class_install_property (G_OBJECT_CLASS (klass),
 				   PROP_LABEL,
 				   pspec);
 }

 static void
 poppler_page_init (PopplerPage *page)
 {
 }


 /**
  * poppler_page_get_link_mapping:
  * @page: A #PopplerPage
  *
  * Returns a list of #PopplerLinkMapping items that map from a
  * location on @page to a #PopplerAction.  This list must be freed
  * with poppler_page_free_link_mapping() when done.
  *
  * Return value: A #GList of #PopplerLinkMapping
  **/
 GList *
 poppler_page_get_link_mapping (PopplerPage *page)
 {
 	GList *map_list = NULL;
 	gint i;
 	Links *links;
 	Object obj;

 	g_return_val_if_fail (POPPLER_IS_PAGE (page), NULL);

 	links = new Links (page->page->getAnnots (&obj),
 			   page->document->doc->getCatalog ()->getBaseURI ());
 	obj.free ();

 	if (links == NULL)
 		return NULL;

 	for (i = 0; i < links->getNumLinks (); i++) {
 		PopplerLinkMapping *mapping;
 		LinkAction *link_action;
 		Link *link;

 		link = links->getLink (i);
 		link_action = link->getAction ();

 		/* Create the mapping */
 		mapping = g_new (PopplerLinkMapping, 1);
 		mapping->action = _poppler_action_new (page->document, link_action, NULL);
 		link->getRect (&(mapping->area.x1), &(mapping->area.y1),
 			       &(mapping->area.x2), &(mapping->area.y2));
 		map_list = g_list_prepend (map_list, mapping);
 	}

 	return map_list;
 }

 static void
 poppler_mapping_free (PopplerLinkMapping *mapping)
 {
 	poppler_action_free (mapping->action);
 	g_free (mapping);
 }

 /**
  * poppler_page_free_link_mapping:
  * @list: A list of #PopplerLinkMapping<!-- -->s
  *
  * Frees a list of #PopplerLinkMapping<!-- -->s allocated by
  * poppler_page_get_link_mapping().  It also frees the #PopplerAction<!-- -->s
  * that each mapping contains, so if you want to keep them around, you need to
  * copy them with poppler_action_copy().
  **/
 void
 poppler_page_free_link_mapping (GList *list)
 {
 	if (list == NULL)
 		return;

 	g_list_foreach (list, (GFunc) (poppler_mapping_free), NULL);
 	g_list_free (list);
 }
	/* poppler.h: glib wrapper for poppler
	* Copyright (C) 2005, Red Hat, Inc.
	*
	* This program 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, or (at your option)
	* any later version.
	*
	* This program 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 <math.h>

	#include <goo/GooList.h>
	#include <splash/SplashBitmap.h>
	#include <GlobalParams.h>
	#include <PDFDoc.h>
	#include <Outline.h>
	#include <ErrorCodes.h>
	#include <UnicodeMap.h>
	#include <GfxState.h>
	#include <SplashOutputDev.h>
	#include <TextOutputDev.h>

	#include "poppler.h"
	#include "poppler-private.h"

	enum
	{
	PROP_0,
	PROP_LABEL
	};

	typedef struct _PopplerPageClass PopplerPageClass;
	struct _PopplerPageClass
	{
	GObjectClass parent_class;
	};

	G_DEFINE_TYPE (PopplerPage, poppler_page, G_TYPE_OBJECT);

	PopplerPage *
	_poppler_page_new (PopplerDocument document, Page page, int index)
	{
	PopplerPage *poppler_page;

	g_return_val_if_fail (POPPLER_IS_DOCUMENT (document), NULL);

	poppler_page = (PopplerPage *) g_object_new (POPPLER_TYPE_PAGE, NULL);
	poppler_page->document = document;
	poppler_page->page = page;
	poppler_page->index = index;

	return poppler_page;
	}

	static void
	poppler_page_finalize (GObject *object)
	{
	/* page->page is owned by the document */
	}

	void
	poppler_page_get_size (PopplerPage *page,
	double *width,
	double *height)
	{
	g_return_if_fail (POPPLER_IS_PAGE (page));

	if (width != NULL)
	*width = page->page->getWidth ();
	if (height != NULL)
	*height = page->page->getHeight ();
	}

	int
	poppler_page_get_index (PopplerPage *page)
	{
	g_return_val_if_fail (POPPLER_IS_PAGE (page), 0);

	return page->index;
	}

	/**
	* poppler_page_render_to_pixbuf:
	* @page: the page to render from
	* @src_x: x coordinate of upper left corner
	* @src_y: y coordinate of upper left corner
	* @src_width: width of rectangle to render
	* @src_height: height of rectangle to render
	* @ppp: pixels per point
	* @pixbuf: pixbuf to render into
	* @dest_x: x coordinate of offset into destination
	* @dest_y: y cooridnate of offset into destination
	*
	* First scale the document to match the specified pixels per point,
	* then render the rectangle given by the upper left corner at
	* (src_x, src_y) and src_width and src_height. The rectangle is
	* rendered into the specified pixmap with the upper left corner
	* placed at (dest_x, dest_y).
	**/
	void
	poppler_page_render_to_pixbuf (PopplerPage *page,
	int src_x, int src_y,
	int src_width, int src_height,
	double scale,
	GdkPixbuf *pixbuf,
	int dest_x, int dest_y)
	{
	SplashOutputDev *output_dev;
	SplashColor white;
	SplashBitmap *bitmap;
	SplashColorPtr color_ptr;
	SplashRGB8 *src;
	int splash_width, splash_height, splash_rowstride;
	int pixbuf_rowstride, pixbuf_n_channels;
	guchar pixbuf_data, dst;
	int x, y;

	g_return_if_fail (POPPLER_IS_PAGE (page));
	g_return_if_fail (scale > 0.0);
	g_return_if_fail (pixbuf != NULL);

	white.rgb8 = splashMakeRGB8 (0xff, 0xff, 0xff);
	output_dev = new SplashOutputDev(splashModeRGB8, gFalse, white);

	output_dev->startDoc(page->document->doc->getXRef ());

	page->page->displaySlice(output_dev, 72.0 * scale, 72.0 * scale,
	0, /* Rotate */
	gTrue, /* Crop */
	src_x, src_y,
	src_width, src_height,
	NULL, /* links */
	page->document->doc->getCatalog ());

	bitmap = output_dev->getBitmap ();
	color_ptr = bitmap->getDataPtr ();

	splash_width = bitmap->getWidth ();
	splash_height = bitmap->getHeight ();
	splash_rowstride = bitmap->getRowSize ();

	pixbuf_data = gdk_pixbuf_get_pixels (pixbuf);
	pixbuf_rowstride = gdk_pixbuf_get_rowstride (pixbuf);
	pixbuf_n_channels = gdk_pixbuf_get_n_channels (pixbuf);

	if (dest_x + splash_width > gdk_pixbuf_get_width (pixbuf))
	splash_width = gdk_pixbuf_get_width (pixbuf) - dest_x;
	if (dest_y + splash_height > gdk_pixbuf_get_height (pixbuf))
	splash_height = gdk_pixbuf_get_height (pixbuf) - dest_y;

	for (y = 0; y < splash_height; y++)
	{
	SplashRGB8 *src;
	SplashRGB8 rgb;

	src = (SplashRGB8 ) (color_ptr.rgb8p + y splash_rowstride);
	dst = pixbuf_data + (dest_y + y) * pixbuf_rowstride +
	dest_x * pixbuf_n_channels;
	for (x = 0; x < splash_width; x++)
	{
	dst[0] = splashRGB8R(*src);
	dst[1] = splashRGB8G(*src);
	dst[2] = splashRGB8B(*src);
	dst += pixbuf_n_channels;
	src++;
	}
	}

	delete output_dev;
	}

	static void
	destroy_thumb_data (guchar *pixels, gpointer data)
	{
	gfree (pixels);
	}

	GdkPixbuf *
	poppler_page_get_thumbnail (PopplerPage *page)
	{
	unsigned char *data;
	int width, height, rowstride;

	g_return_val_if_fail (POPPLER_IS_PAGE (page), FALSE);

	if (!page->page->loadThumb (&data, &width, &height, &rowstride))
	return NULL;

	return gdk_pixbuf_new_from_data (data, GDK_COLORSPACE_RGB,
	FALSE, 8, width, height, rowstride,
	destroy_thumb_data, NULL);
	}

	/**
	* poppler_page_get_thumbnail_size:
	* @page: A #PopplerPage
	* @width: return location for width
	* @height: return location for height
	*
	* Returns %TRUE if @page has a thumbnail associated with it. It also fills in
	* @width and @height with the width and height of the thumbnail. The values of
	* width and height are not changed if no appropriate thumbnail exists.
	*
	* Return value: %TRUE, if @page has a thumbnail associated with it.
	**/
	gboolean
	poppler_page_get_thumbnail_size (PopplerPage *page,
	int *width,
	int *height)
	{
	Object thumb;
	Dict *dict;
	gboolean retval = FALSE;

	g_return_val_if_fail (POPPLER_IS_PAGE (page), FALSE);
	g_return_val_if_fail (width != NULL, FALSE);
	g_return_val_if_fail (height != NULL, FALSE);

	page->page->getThumb (&thumb);
	if (thumb.isNull ())
	{
	thumb.free ();
	return FALSE;
	}

	dict = thumb.streamGetDict();

	/* Theoretically, this could succeed and you would still fail when
	* loading the thumb */
	if (dict->lookupInt ("Width", "W", width) &&
	dict->lookupInt ("Height", "H", height))
	retval = TRUE;

	thumb.free ();

	return retval;
	}

	/**
	* poppler_page_get_text:
	* @page: a #PopplerPage
	* @rect: the rectangle including the text
	*
	* Retrieves the contents of the specified rectangle as text
	*
	* Return value: a pointer to the contents of the rectangle
	* as a string
	**/
	char *
	poppler_page_get_text (PopplerPage *page,
	PopplerRectangle *rect)
	{
	TextOutputDev *output_dev;
	PDFDoc *doc;
	GooString *sel_text = new GooString;
	PopplerRectangle text_dev_rect;
	double height, y1, y2;
	char *result;

	g_return_val_if_fail (POPPLER_IS_PAGE (page), FALSE);
	g_return_val_if_fail (rect != NULL, NULL);

	output_dev = new TextOutputDev (NULL, gTrue, gFalse, gFalse);
	doc = page->document->doc;

	height = page->page->getHeight ();
	page->page->display(output_dev, 72, 72, 0, gTrue, NULL, doc->getCatalog());

	y1 = height - rect->y2;
	y2 = height - rect->y1;
	sel_text = output_dev->getText (rect->x1, y1, rect->x2, y2);
	result = sel_text->getCString ();

	delete output_dev;

	return result ? g_strdup (result) : NULL;
	}

	/**
	* poppler_page_find_text:
	* @page: a #PopplerPage
	* @text: the text to search for (UTF-8 encoded)
	*
	* A #GList of rectangles for each occurance of the text on the page.
	* The coordinates are in PDF points.
	*
	* Return value: a #GList of PopplerRectangle,
	**/
	GList *
	poppler_page_find_text (PopplerPage *page,
	const char *text)
	{
	PopplerRectangle *match;
	TextOutputDev *output_dev;
	PDFDoc *doc;
	GList *matches;
	double xMin, yMin, xMax, yMax;
	gunichar *ucs4;
	glong ucs4_len;
	double height;

	g_return_val_if_fail (POPPLER_IS_PAGE (page), FALSE);
	g_return_val_if_fail (text != NULL, FALSE);

	ucs4 = g_utf8_to_ucs4_fast (text, -1, &ucs4_len);

	output_dev = new TextOutputDev (NULL, gTrue, gFalse, gFalse);
	doc = page->document->doc;

	height = page->page->getHeight ();
	page->page->display (output_dev, 72, 72, 0, gTrue, NULL, doc->getCatalog());

	matches = NULL;
	while (output_dev->findText (ucs4, ucs4_len,
	gFalse, gTrue, // startAtTop, stopAtBottom
	gTrue, gFalse, // startAtLast, stopAtLast
	&xMin, &yMin, &xMax, &yMax))
	{
	match = g_new (PopplerRectangle, 1);
	match->x1 = xMin;
	match->y1 = height - yMax;
	match->x2 = xMax;
	match->y2 = height - yMin;
	matches = g_list_prepend (matches, match);
	}

	delete output_dev;
	g_free (ucs4);

	return g_list_reverse (matches);
	}

	static void
	poppler_page_get_property (GObject *object,
	guint prop_id,
	GValue *value,
	GParamSpec *pspec)
	{
	PopplerPage *page = POPPLER_PAGE (object);
	GooString label;

	switch (prop_id)
	{
	case PROP_LABEL:
	page->document->doc->getCatalog ()->indexToLabel (page->index, &label);
	g_value_set_string (value, label.getCString());
	break;
	}
	}

	static void
	poppler_page_class_init (PopplerPageClass *klass)
	{
	GObjectClass *gobject_class = G_OBJECT_CLASS (klass);
	GParamSpec *pspec;

	gobject_class->finalize = poppler_page_finalize;
	gobject_class->get_property = poppler_page_get_property;

	pspec = g_param_spec_string ("label",
	"Page Label",
	"The label of the page",
	NULL,
	G_PARAM_READABLE);
	g_object_class_install_property (G_OBJECT_CLASS (klass),
	PROP_LABEL,
	pspec);
	}

	static void
	poppler_page_init (PopplerPage *page)
	{
	}


	/**
	* poppler_page_get_link_mapping:
	* @page: A #PopplerPage
	*
	* Returns a list of #PopplerLinkMapping items that map from a
	* location on @page to a #PopplerAction. This list must be freed
	* with poppler_page_free_link_mapping() when done.
	*
	* Return value: A #GList of #PopplerLinkMapping
	**/
	GList *
	poppler_page_get_link_mapping (PopplerPage *page)
	{
	GList *map_list = NULL;
	gint i;
	Links *links;
	Object obj;

	g_return_val_if_fail (POPPLER_IS_PAGE (page), NULL);

	links = new Links (page->page->getAnnots (&obj),
	page->document->doc->getCatalog ()->getBaseURI ());
	obj.free ();

	if (links == NULL)
	return NULL;

	for (i = 0; i < links->getNumLinks (); i++) {
	PopplerLinkMapping *mapping;
	LinkAction *link_action;
	Link *link;

	link = links->getLink (i);
	link_action = link->getAction ();

	/* Create the mapping */
	mapping = g_new (PopplerLinkMapping, 1);
	mapping->action = _poppler_action_new (page->document, link_action, NULL);
	link->getRect (&(mapping->area.x1), &(mapping->area.y1),
	&(mapping->area.x2), &(mapping->area.y2));
	map_list = g_list_prepend (map_list, mapping);
	}

	return map_list;
	}

	static void
	poppler_mapping_free (PopplerLinkMapping *mapping)
	{
	poppler_action_free (mapping->action);
	g_free (mapping);
	}

	/**
	* poppler_page_free_link_mapping:
	* @list: A list of #PopplerLinkMapping<!-- -->s
	*
	* Frees a list of #PopplerLinkMapping<!-- -->s allocated by
	* poppler_page_get_link_mapping(). It also frees the #PopplerAction<!-- -->s
	* that each mapping contains, so if you want to keep them around, you need to
	* copy them with poppler_action_copy().
	**/
	void
	poppler_page_free_link_mapping (GList *list)
	{
	if (list == NULL)
	return;

	g_list_foreach (list, (GFunc) (poppler_mapping_free), NULL);
	g_list_free (list);
	}