METHODS

Constructors

$obj->new( [$components], %options )
$class->new( [$components], %options )

When called as instance method, some defaults are copied from the object where the call is made upon. Usually called as class method.

$components are Math::Polygon, Math::Polygon::Surface, Geo::Point, Geo::Line, Geo::Surface, Geo::Space objects.

Option Defined in Default

proj

Geo::Shape

see Geo::Proj::defaultProjection()

proj => LABEL

Attributes

$obj->component( $index, [$index, ...] )

Returns the component (or components) with the specified $index(es). One Geo::Shape object in scalar context, and multiple in list context.

$obj->components

Returns a list of Geo::Shape objects, all located in this space.

$obj->lines

Returns a list of Geo::Line objects, which are defined as separate components.

$obj->nrComponents

Returns the number of components.

$obj->onlyLines

Returns true when all components are lines; Geo::Line objects.

$obj->onlyPoints

Returns true when all components are points; Geo::Point objects.

$obj->onlyRings

Returns true when all components are closed lines; Geo::Line objects each defined as ring.

$obj->points

Returns a list of Geo::Point objects, which are defined as separate components.

$obj->proj
See proj in Geo::Shape.
$obj->proj4
See proj4 in Geo::Shape.

Projections

$obj->in( <$label|'utm'> )
See in in Geo::Shape.
$obj->projectOn( $nick, @points )
See projectOn in Geo::Shape.

Geometry

$obj->area

Returns the area enclosed by the combined components. Only useful when the points are in some orthogonal projection.

$obj->bbox
See bbox in Geo::Shape.
$obj->bboxCenter
See bboxCenter in Geo::Shape.
$obj->bboxRing( [$xmin, $ymin, $xmax, $ymax, [$proj]] )
$class->bboxRing( [$xmin, $ymin, $xmax, $ymax, [$proj]] )
See bboxRing in Geo::Shape.
$obj->distance( $object, [$unit] )
See distance in Geo::Shape.
$obj->perimeter

The length of the outer polygons of all components. Only useful in a orthogonal coordinate systems.

Display

$obj->deg2dm( $degrees, $pos, $neg )
$class->deg2dm( $degrees, $pos, $neg )
See deg2dm in Geo::Shape.
$obj->deg2dms( $degrees, $pos, $neg )
$class->deg2dms( $degrees, $pos, $neg )
See deg2dms in Geo::Shape.
$obj->dms2deg( $dms )
$class->dms2deg( $dms )
See dms2deg in Geo::Shape.
$obj->toString( [$projection] )

Returns a string representation of the line, which is also used for stringification.

» Example: