/ 
Champlain-0.03
River stage zero No dependents
/ Champlain

NAME

Champlain - Map rendering canvas

SYNOPSIS

use Clutter '-init';
use Champlain;

# Standard clutter canvas
my $stage = Clutter::Stage->get_default();
$stage->set_size(800, 600);

# Create the map view and set some properties
my $map = Champlain::View->new();
$map->set('scroll-mode', 'kinetic');
$map->set_size(800, 600);
$map->set_property('zoom-level', 7);
$map->center_on(45.466, -73.75);

# Pack the actors	
$stage->add($map);
$stage->show_all();

# Main loop
Clutter->main();

DESCRIPTION

Champlain is a Perl binding for the C library libchamplain which provides a canvas widget based on Clutter that displays maps from various free map sources such as OpenStreetMap, OpenArialMap and Maps for free.

If the C library is compiled with GTK support then the map widget can also be embedded in any GTK application.

For more information about libchamplain see: http://projects.gnome.org/libchamplain/.

EXPORTS

The library makes the following constants available:

MIN_LAT
MAX_LAT
MIN_LONG
MAX_LONG

The tag coords can be used for importing the constants providing the minimal and maximal values for (latitude, longitude) coordinates:

use Champlain ':coords';

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 as Perl itself, either Perl version 5.8.8 or, at your option, any later version of Perl 5 you may have available.