Palm::Magellan::NavCompanion - access the Magellan GPS Companion waypoints file
use Palm::Magellan::NavCompanion; my $pdb = Palm::Magellan::NavCompanion->new; $pdb->Load( $file ); my $waypoints = $pdb->{records}; $, = ", "; foreach my $wp ( @$waypoints ) { print $wp->name, $wp->latitude, $wp->longitude; print "\n"; }
This module gives you access to the waypoints in the Magellan's GPS Companion "Companion Waypoints.pdb" file. You have to be able to load that file, which probably means that you have it on your computer rather than your Palm. On my machine, this file shows up in the Palm directory as Palm/Users/..user../Backups/Companion Waypoints.pdb .
Palm/Users/..user../Backups/Companion Waypoints.pdb
Behind-the-scenes, Palm::PDB does all the work, so this module has part of its interface and data structure. For instance, the Load() method accesses and parses the file and returns the general data structure that Palm::PDB creates. The interesting bits (the waypoints) is an anonymous array which is the value for the key records.
records
# an anonymous array my $waypoints = $pdb->{records};
Each element in @{ $waypoints } is an object of class Palm::Magellan::NavCompanion::Record, which is really just a class of accessor methods (for now).
@{ $waypoints }
Palm::Magellan::NavCompanion::Record
Create a new object. This method takes no arguments
Load a file in Palm Database format
The description. The format allows up to 20 characters.
The description. The format allows up to 32 characters.
The altitude, in meters
The latitude, as a decimal number. Positive numbers are north latitude and negative numbers are south latitude.
The longitude, as a decimal number. Positive numbers are east longitude and negative numbers are west longitude.
The creation date of the waypoint, in the format MM/DD/YYYY. This comprises the individual elements found in the database format, which are also available individually.
The creation time of the waypoint, in the format HH:MM.ss This comprises the individual elements found in the database format, which are also available individually.
The second the waypoint was created.
The minute the waypoint was created.
The hour the waypoint was created.
The day the waypoint was created.
The month the waypoint was created.
The year the waypoint was created. It includes the century.
* write records too
Palm::PDB
This source is in GitHub:
https://github.com/CPAN-Adopt-Me/Palm-Magellan-NavCompanion
Now this module has no maintainer. You can takeover maintenance by writing to modules@perl.org.
brian d foy <bdfoy@cpan.org>
<bdfoy@cpan.org>
Copyright (c) 2004-2008 brian d foy. All rights reserved.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
To install Palm::Magellan::NavCompanion::Record, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Palm::Magellan::NavCompanion::Record
CPAN shell
perl -MCPAN -e shell install Palm::Magellan::NavCompanion::Record
For more information on module installation, please visit the detailed CPAN module installation guide.