prajna.geo

Class GeoMultiShape

java.lang.Object

java.util.AbstractCollection<E>

java.util.AbstractList<E>

java.util.ArrayList<GeoShape>

prajna.geo.GeoMultiShape

All Implemented Interfaces:

java.awt.Shape, java.io.Serializable, java.lang.Cloneable, java.lang.Iterable<GeoShape>, java.util.Collection<GeoShape>, java.util.List<GeoShape>, java.util.RandomAccess, Locatable, GeoShape

public class GeoMultiShape
extends java.util.ArrayList<GeoShape>
implements GeoShape

This class forms a composite geographic shape which can be used to group multiple shapes into a single object. It essentially acts as a delegating collection of shapes, passing most methods to its component shapes, and aggregating any results as necessary.

Author:

Edward Swing

See Also:

Serialized Form

Field Summary

Fields inherited from class java.util.AbstractList

modCount

Constructor Summary

Constructors

Constructor and Description
GeoMultiShape()

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 shape
DataRecord	getData() Gets the data record of this GeoMultiShape
GeoBounds	getGeoBounds() Get the geographic bounds for this shape.
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 GeoMultiShape.
RenderStyle	getRenderStyle() Get the rendering style for this GeoMultiShape.
boolean	intersects(double x, double y, double w, double h) Tests if the interior of the Shape intersects the interior of a specified rectangular area.
boolean	intersects(java.awt.geom.Rectangle2D rect) Tests if the interior of the Shape intersects the interior of a specified Rectangle.
void	project(Projection proj) Projects the geographic coordinates into the given projection
void	setData(DataRecord dataRecord) Sets the data record of this GeoMultiShape.
void	setRenderStyle(RenderStyle style) Set the rendering style for this GeoShape.

Methods inherited from class java.util.ArrayList

add, add, addAll, addAll, clear, clone, contains, ensureCapacity, get, indexOf, isEmpty, iterator, lastIndexOf, listIterator, listIterator, remove, remove, removeAll, removeRange, retainAll, set, size, subList, toArray, toArray, trimToSize

Methods inherited from class java.util.AbstractList

equals, hashCode

Methods inherited from class java.util.AbstractCollection

containsAll, toString

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.List

containsAll, equals, hashCode

Constructor Detail

GeoMultiShape

public GeoMultiShape()

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. This method checks the bounds for all component shapes, and creates a union of those bounding boxes.

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. This follows the same algorithm as getBounds().

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 shape

Specified by:

getCenter in interface Locatable

Specified by:

getCenter in interface GeoShape

Returns:

the center of the shape

getData

public DataRecord getData()

Gets the data record of this GeoMultiShape

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

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. This method creates a MultiPathIterator to iterate across all of the component shapes.

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. This method creates a MultiPathIterator to iterate across all of the component shapes.

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 GeoMultiShape.

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 GeoMultiShape.

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 Shape intersects the interior of a specified rectangular area. This method simply checks all component shapes for intersection.

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 Shape intersects the interior of a specified Rectangle. This method simply checks all component shapes for intersection.

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 dataRecord)

Sets the data record of this GeoMultiShape. This does not modify any data that is associated with component shapes within this MultiShape.

Specified by:

setData in interface GeoShape

Parameters:

dataRecord - the data record

setRenderStyle

public void setRenderStyle(RenderStyle style)

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

Specified by:

setRenderStyle in interface GeoShape

Parameters:

style - The rendering style