NAME
Gtk2::Champlain - Gtk2 map rendering widget
SYNOPSIS
use Gtk2::Clutter ':init';
use Gtk2::Champlain;
my $window = Gtk2::Window->new('toplevel');
$window->signal_connect(destroy => sub { Gtk2->main_quit(); });
$window->set_title('Free maps');
$window->set_default_size(800, 600);
# Embeddable map widget
my $embed = Gtk2::Champlain::Embed->new();
$window->add($embed);
# Configure the map view
my $map = $embed->get_view();
$map->set_zoom_level(7);
$map->center_on(45.466, -73.75);
# Show all widgets and start the main loop
$window->show_all();
Gtk2->main();DESCRIPTION
Gtk2::Champlain is a Gtk2 widget that allows Champlain maps to be embeded in any Gtk2 application.
This makes all maps available to Champlain available to Gtk2 application. At the moment various free map sources such as OpenStreetMap, OpenAerialMap and Maps for free can be easily displayed.
For more information about libchamplain-gtk see: http://projects.gnome.org/libchamplain/.
BUGS
The library libchamplain is quite young and its API is changing as the code gains maturity. These bindings try to provide as much coverage from the C library as possible. Don't be surprised if the API changes within the next releases this is normal as libchamplain IS NOT yet API nor ABI frozen.
It's quite probable that bugs will be exposed, please try to report all bugs found through GNOME's Bugzilla http://bugzilla.gnome.org/simple-bug-guide.cgi?product=champlain (when prompted for a component simply choose bindings). GNOME's bug tracking tool is preferred over RT because the bugs found in the library could impact libchamplain or the other bindings. Of course all bugs entered through RT will be acknowledged and addressed.
AUTHORS
Emmanuel Rodriguez <potyl@cpan.org>.
COPYRIGHT AND LICENSE
Copyright (C) 2009 by Emmanuel Rodriguez.
This library is free software; you can redistribute it and/or modify it under the same terms of:
This module 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.
You should have received a copy of the GNU Library General Public License along with this module; if not, see http://www.gnu.org/licenses/.
For the terms of The Artistic License, see perlartistic.