Eric Wilhelm > Math-Geometry-Planar-Offset > Math::Geometry::Planar::Offset

Download:
Math-Geometry-Planar-Offset-1.05.tar.gz

Dependencies

Annotate this POD

Website

CPAN RT

New  1
Open  0
View/Report Bugs
Module Version: 1.05   Source  

NAME ^

Math::Geometry::Planar::Offset - Calculate offset polygons

SYNOPSIS ^

  use Math::Geometry::Planar::Offset;

  my (@results) = OffsetPolygon(\@points, $distance);
  foreach my $polygon (@results) {
    # do something with @$polygon
  }

AUTHOR ^

Eric Wilhelm @ <ewilhelm at cpan dot org>

COPYRIGHT NOTICE ^

Copyright (C) 2003-2007 Eric L. Wilhelm. All rights reserved.

NO WARRANTY ^

Absolutely, positively NO WARRANTY, neither express or implied, is offered with this software. You use this software at your own risk. In case of loss, neither Eric Wilhelm, nor anyone else, owes you anything whatseover. You have been warned.

Note that this includes NO GUARANTEE of MATHEMATICAL CORRECTNESS. If you are going to use this code in a production environment, it is YOUR RESPONSIBILITY to verify that the methods return the correct values.

LICENSE ^

You may use this software under one of the following licenses:

  (1) GNU General Public License 
    (found at http://www.gnu.org/copyleft/gpl.html) 
  (2) Artistic License 
    (found at http://www.perl.com/pub/language/misc/Artistic.html)

BUGS ^

There are currently some problems with concurrent edge events on outward (and maybe inward) offsets. Some significant changes need to be made.

METHODS ^

These methods are actually defined in Math::Geometry::Planar, which uses this module.

offset_polygon

Returns reference to an array of polygons representing the original polygon offsetted by $distance

  $polygon->offset_polygon($distance);

Functions ^

Only OffsetPolygon is exported.

pi

Returns the constant pi

OffsetPolygon

Make offset polygon subroutine.

Call with offset distance and ref to array of points for original polygon polygon input must be pre-wrapped so point[n]=point[0]

Will return a list of polygons (as refs.) The number of polygons in the output depends on the shape of your input polygon. It may split into several pieces during the offset.

  my (@results) = OffsetPolygon(\@points, $distance);
  foreach my $polygon (@results) {
    # do something with @$polygon
  }
syntax highlighting: