org.gvsig.fmap.geom.jts

Class AbstractGeometry

java.lang.Object

org.gvsig.fmap.geom.jts.AbstractGeometry

All Implemented Interfaces:

Shape, Serializable, Comparable, Geometry, GeometryJTS

Direct Known Subclasses:

AbstractAggregate, AbstractPrimitive

public abstract class AbstractGeometry
extends Object
implements GeometryJTS

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface org.gvsig.fmap.geom.Geometry

Geometry.DIMENSIONS, Geometry.OPERATIONS, Geometry.SUBTYPES, Geometry.TYPES, Geometry.ValidationStatus

Field Summary

Fields

Modifier and Type	Field and Description
protected static Logger	logger

Fields inherited from interface org.gvsig.fmap.geom.Geometry

BEST, E, EXTENDED_GEOMSUBTYPE_OFFSET, EXTENDED_GEOMTYPE_OFFSET, N, NE, NW, S, SE, SELECTHANDLER, STRETCHINGHANDLER, SW, W

Constructor Summary

Constructors

Constructor and Description
AbstractGeometry(int type, int subtype)

Method Summary

Modifier and Type	Method and Description
double	area()
Geometry	buffer(double distance) Computes a buffer area around this geometry having the given width This is a utility method to wrap the invocation to the operation Geometry.OPERATIONS.BUFFER.
Point	centroid()
Geometry[]	closestPoints(Geometry other)
int	compareTo(Object o)
boolean	contains(double x, double y)
boolean	contains(double x, double y, double w, double h)
boolean	contains(Geometry geometry) Tests whether this geometry contains the specified geometry.
boolean	contains(Point2D p)
boolean	contains(Rectangle2D r)
byte[]	convertToEWKB() Return a byte array with the equivalent in EWKB format of the Geometry.
byte[]	convertToEWKB(int srs)
byte[]	convertToEWKBForcingType(int srs, int type)
byte[]	convertToWKB() Return a byte array with the equivalent in WKB format of the Geometry.
byte[]	convertToWKB(int srs)
byte[]	convertToWKBForcingType(int srs, int type)
String	convertToWKT() Return a string with the equivalent in WKT format of the Geometry.
Geometry	convexHull()
boolean	coveredBy(Geometry geometry)
boolean	covers(Geometry geometry)
boolean	crosses(Geometry geometry)
Geometry	difference(Geometry other)
boolean	disjoint(Geometry geometry)
double	distance(Geometry other) Returns the minimum distance between this Geometry and the specified geometry.
boolean	ensureOrientation(boolean ccw) Ensures the orientation of the geometry according to the parameter, flipping it if necessary.
boolean	equals(Object obj)
boolean	fastIntersects(double x, double y, double w, double h) Used by the drawing strategies to quickly test whether this geometry intersects with the visible rectangle.
Rectangle	getBounds()
Rectangle2D	getBounds2D() Returns this geometry's boundary rectangle.
Envelope	getEnvelope() Returns the minimum bounding box for this Geometry.
GeometryType	getGeometryType() Instance of the GeometryType associated to this geometry.
Point	getInteriorPoint() This method returns a point which is inside the geometry.
Shape	getInternalShape() Useful to have the real shape behind the scenes.
protected GeometryManager	getManager()
int	getType() If this geometry is a predefined interface then this method returns one of Geometry.TYPES contants.
Geometry.ValidationStatus	getValidationStatus() Check if the geometry is valid and returns the validation status.
Geometry	intersection(Geometry other)
boolean	intersects(double x, double y, double w, double h)
boolean	intersects(Geometry geometry)
boolean	intersects(Rectangle2D r) Returns true if this geometry intersects the rectangle passed as parameter.
Object	invokeOperation(int index, GeometryOperationContext ctx) Invokes a geometry operation given its index and context.
Object	invokeOperation(String opName, GeometryOperationContext ctx) Invokes a geometry operation given its name and context.
boolean	isCCW()
boolean	isSimple() Returns true if this Geometry has no interior point of self-intersection or self-tangency.
boolean	isValid() Check if the geometry is valid.
boolean	isWithinDistance(Geometry other, double distance)
Geometry	makeValid() Try to fix the geometry and return the new geometry.
void	move(double dx, double dy) Shifts geometry by given amount in x and y axes
protected void	notifyDeprecated(String message)
boolean	out(Geometry geometry) Returns true if passed as a parameter geometry is completely out of geometry.
boolean	overlaps(Geometry geometry) Tests whether this geometry overlaps the specified geometry.
double	perimeter()
void	rotate(double radAngle, double basex, double basey) Rotates the geometry by radAngle radians using the given coordinates as center of rotation.
void	scale(Point basePoint, double sx, double sy) Scales geometry in x and y axes by given scale factors using the given point as center of projection.
Geometry	snapTo(Geometry other, double snapTolerance)
String	toString()
boolean	touches(Geometry geometry)
Geometry	union(Geometry other)
boolean	within(Geometry geometry)

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.gvsig.fmap.geom.jts.GeometryJTS

getJTS, is3D

Methods inherited from interface org.gvsig.fmap.geom.Geometry

canBeReprojected, canBeTransformed, cloneGeometry, flip, getDimension, getGeneralPath, getHandlers, getPathIterator, getPathIterator, getShape, getShape, offset, reProject, toLines, toPoints, toPolygons, transform

Field Detail

logger

protected static final Logger logger

Constructor Detail

AbstractGeometry

public AbstractGeometry(int type,
                        int subtype)

Method Detail

getGeometryType

public GeometryType getGeometryType()

Description copied from interface: Geometry

Instance of the GeometryType associated to this geometry.

Specified by:

getGeometryType in interface Geometry

Returns:

The geometry type.

getManager

protected GeometryManager getManager()

contains

public boolean contains(Geometry geometry)
                 throws GeometryOperationNotSupportedException,
                        GeometryOperationException

Description copied from interface: Geometry

Tests whether this geometry contains the specified geometry. This is a utility method to wrap the invocation to the operation Geometry.OPERATIONS.CONTAINS.

Specified by:

contains in interface Geometry

Parameters:

geometry - the Geometry with which to compare this Geometry

Returns:

if this Geometry contains the specified geometry

Throws:

GeometryOperationNotSupportedException

GeometryOperationException

compareTo

public int compareTo(Object o)

Specified by:

compareTo in interface Comparable

contains

public boolean contains(double x,
                        double y)

Specified by:

contains in interface Shape

intersects

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

Specified by:

intersects in interface Shape

contains

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

Specified by:

contains in interface Shape

contains

public boolean contains(Point2D p)

Specified by:

contains in interface Shape

contains

public boolean contains(Rectangle2D r)

Specified by:

contains in interface Shape

distance

public double distance(Geometry other)
                throws GeometryOperationNotSupportedException,
                       GeometryOperationException

Description copied from interface: Geometry

Returns the minimum distance between this Geometry and the specified geometry. This is a utility method to wrap the invocation to the operation Geometry.OPERATIONS.DISTANCE.

Specified by:

distance in interface Geometry

Returns:

the distance between the geometries

Throws:

GeometryOperationNotSupportedException

GeometryOperationException

isWithinDistance

public boolean isWithinDistance(Geometry other,
                                double distance)
                         throws GeometryOperationNotSupportedException,
                                GeometryOperationException

Specified by:

isWithinDistance in interface Geometry

Throws:

GeometryOperationNotSupportedException

GeometryOperationException

overlaps

public boolean overlaps(Geometry geometry)
                 throws GeometryOperationNotSupportedException,
                        GeometryOperationException

Description copied from interface: Geometry

Tests whether this geometry overlaps the specified geometry. This is a utility method to wrap the invocation to the operation Geometry.OPERATIONS.OVERLAPS.

Specified by:

overlaps in interface Geometry

Parameters:

geometry - the Geometry with which to compare this Geometry

Returns:

true if the two geometries overlap.

Throws:

GeometryOperationNotSupportedException

GeometryOperationException

coveredBy

public boolean coveredBy(Geometry geometry)
                  throws GeometryOperationNotSupportedException,
                         GeometryOperationException

Specified by:

coveredBy in interface Geometry

Throws:

GeometryOperationNotSupportedException

GeometryOperationException

covers

public boolean covers(Geometry geometry)
               throws GeometryOperationNotSupportedException,
                      GeometryOperationException

Specified by:

covers in interface Geometry

Throws:

GeometryOperationNotSupportedException

GeometryOperationException

crosses

public boolean crosses(Geometry geometry)
                throws GeometryOperationNotSupportedException,
                       GeometryOperationException

Specified by:

crosses in interface Geometry

Throws:

GeometryOperationNotSupportedException

GeometryOperationException

intersects

public boolean intersects(Geometry geometry)
                   throws GeometryOperationNotSupportedException,
                          GeometryOperationException

Specified by:

intersects in interface Geometry

Throws:

GeometryOperationNotSupportedException

GeometryOperationException

touches

public boolean touches(Geometry geometry)
                throws GeometryOperationNotSupportedException,
                       GeometryOperationException

Specified by:

touches in interface Geometry

Throws:

GeometryOperationNotSupportedException

GeometryOperationException

disjoint

public boolean disjoint(Geometry geometry)
                 throws GeometryOperationNotSupportedException,
                        GeometryOperationException

Specified by:

disjoint in interface Geometry

Throws:

GeometryOperationNotSupportedException

GeometryOperationException

within

public boolean within(Geometry geometry)
               throws GeometryOperationNotSupportedException,
                      GeometryOperationException

Specified by:

within in interface Geometry

Throws:

GeometryOperationNotSupportedException

GeometryOperationException

area

public double area()
            throws GeometryOperationNotSupportedException,
                   GeometryOperationException

Specified by:

area in interface Geometry

Throws:

GeometryOperationNotSupportedException

GeometryOperationException

perimeter

public double perimeter()
                 throws GeometryOperationNotSupportedException,
                        GeometryOperationException

Specified by:

perimeter in interface Geometry

Throws:

GeometryOperationNotSupportedException

GeometryOperationException

intersects

public boolean intersects(Rectangle2D r)

Description copied from interface: Geometry

Returns true if this geometry intersects the rectangle passed as parameter.

Specified by:

intersects in interface Shape

Specified by:

intersects in interface Geometry

Parameters:

r - Rectangle.

Returns:

True, if this intersects r.

fastIntersects

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

Description copied from interface: Geometry

Used by the drawing strategies to quickly test whether this geometry intersects with the visible rectangle.

Specified by:

fastIntersects in interface Geometry

Parameters:

x - The minimum X coordinate.

y - The minimum Y coordinate.

w - The width of the envelope.

h - The height of the envelope.

Returns:

true if this intersects the rectangle defined by the parameters.

getEnvelope

public Envelope getEnvelope()

Description copied from interface: Geometry

Returns the minimum bounding box for this Geometry. This shall be the coordinate region spanning the minimum and maximum value for each ordinate taken on by DirectPositions in this Geometry. The simplest representation for an envelope consists of two DirectPositions, the first one containing all the minimums for each ordinate, and second one containing all the maximums.

Specified by:

getEnvelope in interface Geometry

Returns:

The minimum bounding box for this Geometry.

isSimple

public boolean isSimple()

Description copied from interface: Geometry

Returns true if this Geometry has no interior point of self-intersection or self-tangency. In mathematical formalisms, this means that every point in the interior of the object must have a metric neighborhood whose intersection with the object is isomorphic to an n-sphere, where n is the dimension of this Geometry.

Specified by:

isSimple in interface Geometry

Returns:

If the geometry is simple.

isCCW

public boolean isCCW()
              throws GeometryOperationNotSupportedException,
                     GeometryOperationException

Specified by:

isCCW in interface Geometry

Throws:

GeometryOperationNotSupportedException

GeometryOperationException

invokeOperation

public Object invokeOperation(int index,
                              GeometryOperationContext ctx)
                       throws GeometryOperationNotSupportedException,
                              GeometryOperationException

Description copied from interface: Geometry

Invokes a geometry operation given its index and context.

Specified by:

invokeOperation in interface Geometry

Parameters:

index - Unique index of the operation. Operation code.

ctx - The context of the geometry operation.

Returns:

Object returned by the operation.

Throws:

GeometryOperationNotSupportedException - It is thrown when the operation has been not registered for this geometry.

GeometryOperationException - It is thrown when there is an error executing the operation.

invokeOperation

public Object invokeOperation(String opName,
                              GeometryOperationContext ctx)
                       throws GeometryOperationNotSupportedException,
                              GeometryOperationException

Description copied from interface: Geometry

Invokes a geometry operation given its name and context.

Specified by:

invokeOperation in interface Geometry

Parameters:

opName - Operation name.

ctx - The context of the geometry operation.

Returns:

Object returned by the operation.

Throws:

GeometryOperationNotSupportedException - It is thrown when the operation has been not registered for this geometry.

GeometryOperationException - It is thrown when there is an error executing the operation.

getType

public int getType()

Description copied from interface: Geometry

If this geometry is a predefined interface then this method returns one of Geometry.TYPES contants.
If this geometry is an extended type then this method returns a runtime constant that identifies its type. By convention this value is stored in a constant called .CODE within the geometry class, for instance: Point2D.CODE.

Specified by:

getType in interface Geometry

Returns:

If this geometry is a predefined interface then one of Geometry.TYPES or a runtime constant if it is an extended type.

convertToWKB

public byte[] convertToWKB()
                    throws GeometryOperationNotSupportedException,
                           GeometryOperationException

Description copied from interface: Geometry

Return a byte array with the equivalent in WKB format of the Geometry. Utility method to wrap the invocation to the operation Geometry.OPERATIONS.CONVERTTOWKB.

Specified by:

convertToWKB in interface Geometry

Returns:

the WKB version of the geometry

Throws:

GeometryOperationNotSupportedException

GeometryOperationException

convertToWKB

public byte[] convertToWKB(int srs)
                    throws GeometryOperationNotSupportedException,
                           GeometryOperationException

Specified by:

convertToWKB in interface Geometry

Throws:

GeometryOperationNotSupportedException

GeometryOperationException

convertToWKBForcingType

public byte[] convertToWKBForcingType(int srs,
                                      int type)
                               throws GeometryOperationNotSupportedException,
                                      GeometryOperationException

Specified by:

convertToWKBForcingType in interface Geometry

Throws:

GeometryOperationNotSupportedException

GeometryOperationException

convertToEWKB

public byte[] convertToEWKB()
                     throws GeometryOperationNotSupportedException,
                            GeometryOperationException

Description copied from interface: Geometry

Return a byte array with the equivalent in EWKB format of the Geometry. Utility method to wrap the invocation to the operation OPERATIONS#CONVERTTOEWKB.

Specified by:

convertToEWKB in interface Geometry

Returns:

the EWKB version of the geometry

Throws:

GeometryOperationNotSupportedException

GeometryOperationException

convertToEWKB

public byte[] convertToEWKB(int srs)
                     throws GeometryOperationNotSupportedException,
                            GeometryOperationException

Specified by:

convertToEWKB in interface Geometry

Throws:

GeometryOperationNotSupportedException

GeometryOperationException

convertToEWKBForcingType

public byte[] convertToEWKBForcingType(int srs,
                                       int type)
                                throws GeometryOperationNotSupportedException,
                                       GeometryOperationException

Specified by:

convertToEWKBForcingType in interface Geometry

Throws:

GeometryOperationNotSupportedException

GeometryOperationException

convertToWKT

public String convertToWKT()
                    throws GeometryOperationNotSupportedException,
                           GeometryOperationException

Description copied from interface: Geometry

Return a string with the equivalent in WKT format of the Geometry. This is a utility method to wrap the invocation to the operation Geometry.OPERATIONS.CONVERTTOWKT.

Specified by:

convertToWKT in interface Geometry

Returns:

the WKT version of the geometry.

Throws:

GeometryOperationNotSupportedException

GeometryOperationException

buffer

public Geometry buffer(double distance)
                throws GeometryOperationNotSupportedException,
                       GeometryOperationException

Description copied from interface: Geometry

Computes a buffer area around this geometry having the given width This is a utility method to wrap the invocation to the operation Geometry.OPERATIONS.BUFFER.

Specified by:

buffer in interface Geometry

Parameters:

distance - the width of the buffer

Returns:

a new Geometry with the computed buffer.

Throws:

GeometryOperationNotSupportedException

GeometryOperationException

snapTo

public Geometry snapTo(Geometry other,
                       double snapTolerance)
                throws GeometryOperationNotSupportedException,
                       GeometryOperationException

Specified by:

snapTo in interface Geometry

Throws:

GeometryOperationNotSupportedException

GeometryOperationException

getInteriorPoint

public Point getInteriorPoint()
                       throws GeometryOperationNotSupportedException,
                              GeometryOperationException

Description copied from interface: Geometry

This method returns a point which is inside the geometry. This is useful for mathematical purposes but it is very unlikely to be a suitable place for a label, for example.

Specified by:

getInteriorPoint in interface Geometry

Returns:

an interior point

Throws:

GeometryOperationNotSupportedException

GeometryOperationException

isValid

public boolean isValid()

Description copied from interface: Geometry

Check if the geometry is valid.

Specified by:

isValid in interface Geometry

Returns:

true if the geometry is valid.

getValidationStatus

public Geometry.ValidationStatus getValidationStatus()

Description copied from interface: Geometry

Check if the geometry is valid and returns the validation status.

Specified by:

getValidationStatus in interface Geometry

Returns:

the ValidationStatus

makeValid

public Geometry makeValid()

Description copied from interface: Geometry

Try to fix the geometry and return the new geometry. If the geometry is valid return the same geometry. If the geometry is corrupt or can't fix it, return null.

Specified by:

makeValid in interface Geometry

Returns:

the new fixed geometry

getBounds2D

public Rectangle2D getBounds2D()

Description copied from interface: Geometry

Returns this geometry's boundary rectangle.

Specified by:

getBounds2D in interface Shape

Specified by:

getBounds2D in interface Geometry

Returns:

Boundary rectangle.

getBounds

public Rectangle getBounds()

Specified by:

getBounds in interface Shape

getInternalShape

public Shape getInternalShape()

Description copied from interface: Geometry

Useful to have the real shape behind the scenes. May be uses to edit it knowing it it is a Circle, Ellipse, etc.

Specified by:

getInternalShape in interface Geometry

Returns:

The awt shape

rotate

public void rotate(double radAngle,
                   double basex,
                   double basey)

Description copied from interface: Geometry

Rotates the geometry by radAngle radians using the given coordinates as center of rotation. Rotating with a positive angle rotates points on the positive x axis toward the positive y axis. In most cases, we assume x increases rightwards and y increases upwards, so in most cases, a positive angle will mean counter-clockwise rotation.

Specified by:

rotate in interface Geometry

Parameters:

radAngle - the amount of rotation, in radians

basex - x coordinate of center of rotation

basey - y coordinate of center of rotation

move

public void move(double dx,
                 double dy)

Description copied from interface: Geometry

Shifts geometry by given amount in x and y axes

Specified by:

move in interface Geometry

scale

public void scale(Point basePoint,
                  double sx,
                  double sy)

Description copied from interface: Geometry

Scales geometry in x and y axes by given scale factors using the given point as center of projection.

Specified by:

scale in interface Geometry

sx - scale factor in x axis

sy - scale factor in y axis

closestPoints

public Geometry[] closestPoints(Geometry other)
                         throws GeometryOperationNotSupportedException,
                                GeometryOperationException

Specified by:

closestPoints in interface Geometry

Throws:

GeometryOperationNotSupportedException

GeometryOperationException

convexHull

public Geometry convexHull()
                    throws GeometryOperationNotSupportedException,
                           GeometryOperationException

Specified by:

convexHull in interface Geometry

Throws:

GeometryOperationNotSupportedException

GeometryOperationException

difference

public Geometry difference(Geometry other)
                    throws GeometryOperationNotSupportedException,
                           GeometryOperationException

Specified by:

difference in interface Geometry

Throws:

GeometryOperationNotSupportedException

GeometryOperationException

intersection

public Geometry intersection(Geometry other)
                      throws GeometryOperationNotSupportedException,
                             GeometryOperationException

Specified by:

intersection in interface Geometry

Throws:

GeometryOperationNotSupportedException

GeometryOperationException

union

public Geometry union(Geometry other)
               throws GeometryOperationNotSupportedException,
                      GeometryOperationException

Specified by:

union in interface Geometry

Throws:

GeometryOperationNotSupportedException

GeometryOperationException

centroid

public Point centroid()
               throws GeometryOperationNotSupportedException,
                      GeometryOperationException

Specified by:

centroid in interface Geometry

Throws:

GeometryOperationNotSupportedException

GeometryOperationException

notifyDeprecated

protected void notifyDeprecated(String message)

ensureOrientation

public boolean ensureOrientation(boolean ccw)
                          throws GeometryOperationNotSupportedException,
                                 GeometryOperationException

Description copied from interface: Geometry

Ensures the orientation of the geometry according to the parameter, flipping it if necessary. If the geometry is a polygon, ensures the orientation of its perimeter and ensures the opposite orientation of their holes.

Specified by:

ensureOrientation in interface Geometry

Returns:

Throws:

GeometryOperationNotSupportedException

GeometryOperationException

out

public boolean out(Geometry geometry)
            throws GeometryOperationNotSupportedException,
                   GeometryOperationException

Description copied from interface: Geometry

Returns true if passed as a parameter geometry is completely out of geometry.

Specified by:

out in interface Geometry

Returns:

Throws:

GeometryOperationNotSupportedException

GeometryOperationException

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

toString

public String toString()

Overrides:

toString in class Object