Champlain
=========

Perl bindings for the C library "libchamplain" that provides a ClutterActor for
displaying geographical maps from various free sources. 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 be embedded in
any Gtk2 application (look for Gtk2::Champlain on CPAN).

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 library is free software; you can redistribute it and/or modify it under
the terms of the GNU Library General Public License as published by the Free
Software Foundation; either version 2.1 of the License, or (at your option)
any later version; or the Artistic License, version 2.0.

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.

You should have received a copy of the GNU Library 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.