org.gvsig.fmap.geom.primitive

Interface OrientablePrimitive

All Superinterfaces:

Comparable, Geometry, Primitive, Serializable, Shape

All Known Subinterfaces:

Arc, Circle, Circumference, Curve, Ellipse, EllipticArc, FilledSpline, Line, OrientableCurve, OrientableSurface, PeriEllipse, Polygon, Ring, Spline, Surface

All Known Implementing Classes:

AbstractArc, AbstractCircle, AbstractEllipse, AbstractEllipticArc, AbstractSurface, Arc2D, Arc2D, Arc2DZ, Arc2DZ, BaseCircle2D, BaseCircle2DZ, BaseEllipse2D, BaseEllipse2DZ, BaseEllipticArc2D, BaseEllipticArc2DZ, Circle2D, Circle2D, Circle2DZ, Circle2DZ, Circumference2D, Circumference2DZ, DefaultCurve, Ellipse2D, Ellipse2D, Ellipse2DZ, Ellipse2DZ, EllipticArc2D, EllipticArc2D, EllipticArc2DZ, EllipticArc2DZ, FilledSpline2D, FilledSpline2DM, FilledSpline3D, FilledSpline3DM, Line2D, Line2D, Line2DM, Line2DZ, Line3D, Line3DM, OrientableCurve2D, OrientablePrimitive2D, OrientableSurface2D, PeriEllipse2D, PeriEllipse2DZ, Polygon2D, Polygon2D, Polygon2DM, Polygon2DZ, Polygon3D, Polygon3DM, Ring2D, Ring2DM, Ring3D, Ring3DM, Spline2D, Spline2D, Spline2DM, Spline2DZ, Spline3D, Spline3DM

public interface OrientablePrimitive
extends Primitive

This interface is equivalent to the GM_OrientablePrimitive specified in ISO 19107. Orientable primitives are those that can be mirrored into new geometric objects in terms of their internal local coordinate systems (manifold charts).

For curves, the orientation reflects the direction in which the curve is traversed, that is, the sense of its parameterization. When used as boundary curves, the surface being bounded is to the "left" of the oriented curve.

For surfaces, the orientation reflects from which direction the local coordinate system can be viewed as right handed, the "top" or the surface being the direction of a completing z-axis that would form a right-handed system.

When used as a boundary surface, the bounded solid is "below" the surface. The orientation of points and solids has no immediate geometric interpretation in 3-dimensional space.

OrientablePrimitive objects are essentially references to geometric primitives that carry an "orientation" reversal flag (either "+" or "-") that determines whether this primitive agrees or disagrees with the orientation of the referenced object.

See Also:

ISO 19107

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

Method Summary

Methods

Modifier and Type	Method and Description
void	addMoveToVertex(Point point) Deprecated. create a multigeometry or use methods to add an inner surface
void	addVertex(double x, double y) Utility method for add a vertex
void	addVertex(double x, double y, double z) Utility method for add a vertex
void	addVertex(Point point) Adds a vertex (or direct position) to the curve
void	closePrimitive() Deprecated. create a multigeometry, and it is not necessary to close a geometry.
void	ensureCapacity(int capacity)
double	getCoordinateAt(int index, int dimension) Gets the one of the values of a coordinate (direct position) in a concrete dimension.
int	getNumVertices() Gets the number of vertices (direct positions) of the curve
Point	getVertex(int index) Gets a vertex (direct position)
void	insertVertex(int index, Point p) Inserts a vertex (direct position) to the curve.
void	removeVertex(int index) Remove a vertex (direct position) to the curve
void	setCoordinateAt(int index, int dimension, double value) Sets the value of a coordinate (direct position) in a concrete dimension
void	setGeneralPath(GeneralPathX generalPathX) Deprecated. use addVertex
void	setVertex(int index, Point p) Sets a vertex in a concrete position and replaces the previous one that was in this position.

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

area, buffer, centroid, cloneGeometry, closestPoints, contains, convertToEWKB, convertToEWKB, convertToEWKBForcingType, convertToWKB, convertToWKB, convertToWKBForcingType, convertToWKT, convexHull, coveredBy, covers, crosses, difference, disjoint, distance, ensureOrientation, fastIntersects, flip, getBounds2D, getDimension, getEnvelope, getGeneralPath, getGeometryType, getHandlers, getInteriorPoint, getInternalShape, getPathIterator, getPathIterator, getShape, getShape, getType, getValidationStatus, intersection, intersects, intersects, invokeOperation, invokeOperation, isCCW, isSimple, isValid, isWithinDistance, makeValid, move, offset, out, overlaps, perimeter, reProject, rotate, scale, snapTo, toLines, toPoints, toPolygons, touches, transform, union, within

Methods inherited from interface java.awt.Shape

contains, contains, contains, contains, getBounds, intersects

Methods inherited from interface java.lang.Comparable

compareTo

Method Detail

getCoordinateAt

double getCoordinateAt(int index,
                     int dimension)

Gets the one of the values of a coordinate (direct position) in a concrete dimension.

Parameters:

index - The index of the direct position to set.

dimension - The dimension of the direct position.

Returns:

The value of the coordinate

setCoordinateAt

void setCoordinateAt(int index,
                   int dimension,
                   double value)

Sets the value of a coordinate (direct position) in a concrete dimension

Parameters:

index - The index of the direct position to set

dimension - The dimension of the direct position

value - The value to set

addVertex

void addVertex(Point point)

Adds a vertex (or direct position) to the curve

Parameters:

point - The new point to add

addVertex

void addVertex(double x,
             double y)

Utility method for add a vertex

Parameters:

x -

y -

See Also:

addVertex(Point)

addVertex

void addVertex(double x,
             double y,
             double z)

Utility method for add a vertex

Parameters:

x -

y -

z -

See Also:

addVertex(Point)

removeVertex

void removeVertex(int index)

Remove a vertex (direct position) to the curve

Parameters:

index - The index of the vertex to remove

getVertex

Point getVertex(int index)

Gets a vertex (direct position)

Parameters:

index - The index of the vertex to get

Returns:

One point

getNumVertices

int getNumVertices()

Gets the number of vertices (direct positions) of the curve

Returns:

The number of vertices

insertVertex

void insertVertex(int index,
                Point p)

Inserts a vertex (direct position) to the curve.

Parameters:

index - The index of the vertex where the new point has to be added.

p - The vertex to add.

setVertex

void setVertex(int index,
             Point p)

Sets a vertex in a concrete position and replaces the previous one that was in this position.

Parameters:

index - The index of the vertex where the new point has to be replaced.

p - The vertex to set.

setGeneralPath

void setGeneralPath(GeneralPathX generalPathX)

Deprecated. use addVertex

Sets all the coordinates of the curve

Parameters:

generalPathX - The generalPath that contains all the coordinates

addMoveToVertex

void addMoveToVertex(Point point)

Deprecated. create a multigeometry or use methods to add an inner surface

Adds a vertex (or direct position) to the curve

Parameters:

point - The new point to add

closePrimitive

void closePrimitive()

Deprecated. create a multigeometry, and it is not necessary to close a geometry.

Closes the geometry

ensureCapacity

void ensureCapacity(int capacity)