prajna.geo

Class GeoPolyline

java.lang.Object

prajna.geo.GeoPolyline

All Implemented Interfaces:

java.awt.Shape, java.io.Serializable, Locatable, GeoShape

Direct Known Subclasses:

GeoBearing

public class GeoPolyline
extends java.lang.Object
implements GeoShape

Geometric shape which represents a polygonal line segment. This line segment can include multiple coordinate points. The line segment is not closed.

Author:

Edward Swing

See Also:

Serialized Form

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	GeoPolyline() Create an empty geographic polyline.
	GeoPolyline(GeoCoord[] coordinates) Create a geographic polygonal line segment with the given coordinates

Method Summary

Methods

Modifier and Type	Method and Description
boolean	contains(double x, double y) Tests if the specified coordinates are inside the boundary of the Shape.
boolean	contains(double x, double y, double w, double h) Tests if the interior of the Shape entirely contains the specified rectangular area.
boolean	contains(java.awt.geom.Point2D point) Tests if the specified point is inside the boundary of the Shape
boolean	contains(java.awt.geom.Rectangle2D rect) Tests if the interior of the Shape entirely contains the specified rectangular area.
java.awt.Rectangle	getBounds() Returns an integer Rectangle that completely encloses the Shape.
java.awt.geom.Rectangle2D	getBounds2D() Returns a high-precision Rectangle that completely encloses the Shape.
GeoCoord	getCenter() Get the center of the GeoPolyline
java.util.List<GeoCoord>	getCoordinates() Return the list of coordinates for this GeoPolyline
DataRecord	getData() Gets the data record associated with this GeoPolyline
GeoBounds	getGeoBounds() Get the geographic bounds for this shape.
GeoCoord[]	getGeoPoints() Returns the list of Geographic coordinates for this GeoPolyline
java.awt.geom.PathIterator	getPathIterator(java.awt.geom.AffineTransform at) Returns an iterator object that iterates along the Shape boundary and provides access to the geometry of the Shape outline.
java.awt.geom.PathIterator	getPathIterator(java.awt.geom.AffineTransform at, double flatness) Returns an iterator object that iterates along the Shape boundary and provides access to a flattened view of the Shape outline geometry.
double	getRadius() Get the radius for this GeoPolyline
RenderStyle	getRenderStyle() Get the rendering style for this GeoPolyline.
boolean	intersects(double x, double y, double w, double h) Tests if the interior of the GeoPolyline intersects the interior of a specified rectangular area.
boolean	intersects(java.awt.geom.Rectangle2D rect) Tests if the interior of the GeoPolyline intersects the interior of a specified Rectangle
void	project(Projection proj) Projects the geographic coordinates into the given projection
void	setData(DataRecord rec) Sets the data record of this GeoPolyline.
protected void	setGeoPoints(GeoCoord[] coordinates) Set the geographic coordinates for this polyline.
void	setRenderStyle(RenderStyle style) Set the rendering style for this GeoPolyline.
java.lang.String	toString() Return a string representation of this GeoPolyline.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

GeoPolyline

protected GeoPolyline()

Create an empty geographic polyline. This initializer is available for subclasses which need to compute points. It should be followed by a call to setGeoPoints

GeoPolyline

public GeoPolyline(GeoCoord[] coordinates)

Create a geographic polygonal line segment with the given coordinates

Parameters:

coordinates - coordinates for the polyline

Method Detail

contains

public boolean contains(double x,
               double y)

Tests if the specified coordinates are inside the boundary of the Shape.

Specified by:

contains in interface java.awt.Shape

Parameters:

x - the specified x coordinate

y - the specified x coordinate

Returns:

true if the specified coordinates are inside the Shape boundary; false otherwise.

contains

public boolean contains(double x,
               double y,
               double w,
               double h)

Tests if the interior of the Shape entirely contains the specified rectangular area.

Specified by:

contains in interface java.awt.Shape

Parameters:

x - the x coordinate of the specified rectangular area

y - the y coordinate of the specified rectangular area

w - the width of the specified rectangular area

h - the height of the specified rectangular area

Returns:

true if the rectangle is contained within the shape, false otherwise

contains

public boolean contains(java.awt.geom.Point2D point)

Tests if the specified point is inside the boundary of the Shape

Specified by:

contains in interface java.awt.Shape

Parameters:

point - the specified point

Returns:

true if the specified point is inside the shape, false otherwise.

contains

public boolean contains(java.awt.geom.Rectangle2D rect)

Tests if the interior of the Shape entirely contains the specified rectangular area.

Specified by:

contains in interface java.awt.Shape

Parameters:

rect - the specified rectangle

Returns:

true if the rectangle is contained within the shape, false otherwise

getBounds

public java.awt.Rectangle getBounds()

Returns an integer Rectangle that completely encloses the Shape.

Specified by:

getBounds in interface java.awt.Shape

Returns:

a Rectangle that completely encloses the Shape.

getBounds2D

public java.awt.geom.Rectangle2D getBounds2D()

Returns a high-precision Rectangle that completely encloses the Shape.

Specified by:

getBounds2D in interface java.awt.Shape

Returns:

a Rectangle that completely encloses the Shape.

getCenter

public GeoCoord getCenter()

Get the center of the GeoPolyline

Specified by:

getCenter in interface Locatable

Specified by:

getCenter in interface GeoShape

Returns:

the center of the GeoPolyline

getCoordinates

public java.util.List<GeoCoord> getCoordinates()

Return the list of coordinates for this GeoPolyline

Returns:

the coordinate list

getData

public DataRecord getData()

Gets the data record associated with this GeoPolyline

Specified by:

getData in interface GeoShape

Returns:

the data record

getGeoBounds

public GeoBounds getGeoBounds()

Get the geographic bounds for this shape.

Specified by:

getGeoBounds in interface GeoShape

Returns:

the geographic bounds for this shape

getGeoPoints

public GeoCoord[] getGeoPoints()

Returns the list of Geographic coordinates for this GeoPolyline

Returns:

the list of Geographic coordinates for this GeoPolyline

getPathIterator

public java.awt.geom.PathIterator getPathIterator(java.awt.geom.AffineTransform at)

Returns an iterator object that iterates along the Shape boundary and provides access to the geometry of the Shape outline.

Specified by:

getPathIterator in interface java.awt.Shape

Parameters:

at - an optional AffineTransform to be applied to the coordinates as they are returned in the iteration, or null if untransformed coordinates are desired

Returns:

a new PathIterator that independently traverses the Shape geometry.

getPathIterator

public java.awt.geom.PathIterator getPathIterator(java.awt.geom.AffineTransform at,
                                         double flatness)

Returns an iterator object that iterates along the Shape boundary and provides access to a flattened view of the Shape outline geometry.

Specified by:

getPathIterator in interface java.awt.Shape

Parameters:

at - an optional AffineTransform to be applied to the coordinates as they are returned in the iteration, or null if untransformed coordinates are desired

flatness - the maximum distance that the line segments used to approximate the curved segments are allowed to deviate from any point on the original curve

Returns:

a new PathIterator that independently traverses the Shape geometry.

getRadius

public double getRadius()

Get the radius for this GeoPolyline

Specified by:

getRadius in interface Locatable

Specified by:

getRadius in interface GeoShape

Returns:

the radius, in meters

getRenderStyle

public RenderStyle getRenderStyle()

Get the rendering style for this GeoPolyline.

Specified by:

getRenderStyle in interface GeoShape

Returns:

the Rendering style

intersects

public boolean intersects(double x,
                 double y,
                 double w,
                 double h)

Tests if the interior of the GeoPolyline intersects the interior of a specified rectangular area.

Specified by:

intersects in interface java.awt.Shape

Parameters:

x - the x coordinate of the specified rectangular area

y - the y coordinate of the specified rectangular area

w - the width of the specified rectangular area

h - the height of the specified rectangular area

Returns:

true if the interior of the Shape and the interior of the rectangular area intersect, false otherwise

intersects

public boolean intersects(java.awt.geom.Rectangle2D rect)

Tests if the interior of the GeoPolyline intersects the interior of a specified Rectangle

Specified by:

intersects in interface java.awt.Shape

Parameters:

rect - the specified Rectangle

Returns:

true if the interior of the Shape and the interior of the rectangular area intersect, false otherwise

See Also:

Path2D.intersects(java.awt.geom.Rectangle2D)

project

public void project(Projection proj)

Projects the geographic coordinates into the given projection

Specified by:

project in interface GeoShape

Parameters:

proj - the Projection for the conversion

setData

public void setData(DataRecord rec)

Sets the data record of this GeoPolyline.

Specified by:

setData in interface GeoShape

Parameters:

rec - the data record associated with this GeoPolyline

setGeoPoints

protected void setGeoPoints(GeoCoord[] coordinates)

Set the geographic coordinates for this polyline. Subclasses which need to compute the geographic points may use this method to initialize the coordinates.

Parameters:

coordinates - the coordinates for the geographic polyline

setRenderStyle

public void setRenderStyle(RenderStyle style)

Set the rendering style for this GeoPolyline. Any fields specifically set for a GeoPolyline should override the layer's default style.

Specified by:

setRenderStyle in interface GeoShape

Parameters:

style - The rendering style

toString

public java.lang.String toString()

Return a string representation of this GeoPolyline.

Overrides:

toString in class java.lang.Object

Returns:

a string representation of this GeoPolyline.