Champlain
=========

Perl bindings for the C library "libchamplain" that provides a ClutterActor for
displaying maps. Libchamplain provides a simple mechanism for rendering maps in
an application or for embedding maps in an existing application.

The library relies on Clutter for all rendering and can easily embedded in any
Gtk2 application. 

The maps displayed are taken from various sources, all providing maps for free,
at the moment the following sources area available: OpenStreetMap, OpenAerialMap
and Maps for free. It's also possible to provide other sources through a simple
API.

For more information about libchamplain refer to the library's web site:

	http://projects.gnome.org/libchamplain/


INSTALLATION

To install this module, run the following commands:

	perl Makefile.PL
	make
	make test
	make install


SUPPORT AND DOCUMENTATION

After installing, you can find documentation for this module with the
perldoc command.

	perldoc Champlain

Also feel free to take a look at the examples in the folder "examples/" and to
play around with them.

For any kind of help or support, simply send a mail to the libchamplain mailing
list (libchamplain-list@gnome.org) or join us in the IRC channel #champlain on
freenode.


COPYRIGHT AND LICENCE

Copyright (C) 2009 Emmanuel Rodriguez

This program is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.

