NAME
Math::Shape::Point
VERSION
version 0.06
SYNOPSIS
use Math::Shape::Point;
use Math::Trig ':pi';
my $p0 = Math::Shape::Point->new(0, 0, 0);
my $p1 = Math::Shape::Point->new(5, 5, 0);
$p0->rotateAboutPoint($p1, pip2);
my $angle = $p0->getAngleToPoint($p1);
my $distance = $p0->getDistanceToPoint($p1);DESCRIPTION
This module is designed to provide some useful 2d functions for manipulating point shapes in cartesian space. Advanced features include rotating around another point, calculating the distance to a point and the calculating the angle to another point. The module uses cartesian coordinates and radians throughout.
NAME
Math::Shape::Point - a 2d point object in cartesian space with utility angle methods
METHODS
new
Instantiates a new point object. Requires the x and y cartesian coordinates and the facing direction in radians.
getLocation
Returns an arrayref containing the point's location in cartesian coordinates.
setLocation
Sets the point's location in cartesian coordinates. Requires two numbers as inputs for the x and y location.
getDirection
Returns the current facing direction in radians.
setDirection
Sets the current facing direction in radians.
advance
Requires a numeric distance argument - moves the point forward that distance in Cartesian coordinates towards the direction it is facing.
rotate
Updates the point's facing direction by radians.
rotateAboutPoint
Rotates the point around another point of origin. Requires a point object and the angle in radians to rotate. This method updates the facing direction of the point object, as well as it's location.
getDistanceToPoint
Returns the distance to another point object. Requires a point object as an argument.
getAngleToPoint
Returns the angle of another point object. Requires a point as an argument.
getDirectionToPoint
Returns the direction of another point objection as a string (front, right, back or left). Assumes a 90 degree angle per direction. Requires a point object as an argument.
normalizeRadian
Takes a radian argument and returns it between 0 and PI2. Negative numbers are assumed to be backwards (e.g. -1.57 == PI + PI / 2)
AUTHOR
David Farrell, <davidnmfarrell at gmail.com>, perltricks.com
BUGS
Please report any bugs or feature requests to bug-math-shape-point at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=math-shape-point. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.
SUPPORT
You can find documentation for this module with the perldoc command.
perldoc Math::Shape::PointREPOSITORY
https://github.com/sillymoose/Math-Shape-Point.git
AUTHOR
David Farrell <sillymoos@cpan.org>
COPYRIGHT AND LICENSE
This software is copyright (c) 2014 by David Farrell.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.