org.opengis.geometry.primitive
Interface OrientableSurface

All Superinterfaces:

Geometry, OrientablePrimitive, Primitive, TransfiniteSet

All Known Subinterfaces:

CompositeSurface, PolyhedralSurface, Shell, Surface, Tin, TriangulatedSurface

@UML(identifier="GM_OrientableSurface",
     specification=ISO_19107)
public interface OrientableSurface
extends OrientablePrimitive

A surface and an orientation inherited from OrientablePrimitive. If the orientation is positive, then the OrientableSurface is a surface. If the orientation is negative, then the OrientableSurface is a reference to a surface with an upNormal that reverses the direction for this OrientableSurface, the sense of "the top of the surface".

Since:

GeoAPI 1.0

Author:

Martin Desruisseaux (IRD)

Method Summary

SurfaceBoundary	getBoundary() Returns the set of circular sequences of orientable curve that limit the extent of this OrientableSurface.
CompositeSurface	getComposite() Returns the owner of this orientable surface.
Surface	getPrimitive() Returns the primitive associated with this OrientableSurface.

Methods inherited from interface OrientablePrimitive

getOrientation

Methods inherited from interface Primitive

getComplexes, getContainedPrimitives, getContainingPrimitives, getProxy

Methods inherited from interface Geometry

clone, distance, getBuffer, getCentroid, getClosure, getConvexHull, getCoordinateDimension, getCoordinateReferenceSystem, getDimension, getEnvelope, getMaximalComplex, getMbRegion, getPrecision, getRepresentativePoint, isCycle, isMutable, isSimple, toImmutable, transform, transform

Methods inherited from interface TransfiniteSet

contains, contains, difference, equals, intersection, intersects, symmetricDifference, union

Method Detail

getBoundary

@UML(identifier="boundary",
     obligation=MANDATORY,
     specification=ISO_19107)
SurfaceBoundary getBoundary()

Returns the set of circular sequences of orientable curve that limit the extent of this OrientableSurface. These curves shall be organized into one circular sequence of curves for each boundary component of the OrientableSurface. In cases where "exterior" boundary is not well defined, all the rings of the surface boundary shall be listed as "interior".

NOTE: The concept of exterior boundary for a surface is really only valid in a 2-dimensional plane. A bounded cylinder has two boundary components, neither of which can logically be classified as its exterior. Thus, in 3 dimensions, there is no valid definition of exterior that covers all cases.

Specified by:

getBoundary in interface Geometry

Specified by:

getBoundary in interface Primitive

Returns:

The sets of positions on the boundary.

See Also:

Geometry.getMbRegion(), Geometry.getClosure(), Geometry.getBuffer(double), #getDistance

getPrimitive

@Association(value="Oriented")
@UML(identifier="primitive",
     obligation=OPTIONAL,
     specification=ISO_19107)
Surface getPrimitive()

Returns the primitive associated with this OrientableSurface.

Specified by:

getPrimitive in interface OrientablePrimitive

Returns:

The primitive, or null if the association is not available or not implemented that way.

See Also:

Surface.getProxy()

getComposite

@Association(value="Composition")
@UML(identifier="composite",
     obligation=OPTIONAL,
     specification=ISO_19107)
CompositeSurface getComposite()

Returns the owner of this orientable surface. This method is optional since the association in ISO 19107 is navigable only from CompositeSurface to OrientableSurface, not the other way.

Specified by:

getComposite in interface Primitive

Returns:

The owner of this orientable surface, or null if the association is not available or not implemented that way.

See Also:

CompositeSurface.getGenerators()