Package org.geotoolkit.geometry

Basic geometric objects.

See:
Description

Class Summary

AbstractDirectPosition	Base class for direct position implementations.
AbstractEnvelope	Base class for envelope implementations.
DirectPosition1D	Holds the coordinates for a one-dimensional position within some coordinate reference system.
DirectPosition2D	Holds the coordinates for a two-dimensional position within some coordinate reference system.
Envelope2D	A two-dimensional envelope on top of Rectangle2D.
Envelopes	Utility methods for envelopes.
GeneralDirectPosition	Holds the coordinates for a position within some coordinate reference system.
GeneralEnvelope	A minimum bounding box or rectangle.
ImmutableEnvelope	Immutable representation of an envelope.
TransformedDirectPosition	A direct position capable to transform a point between an arbitrary CRS and its own CRS.

Package org.geotoolkit.geometry Description

Basic geometric objects. Every geometry objects are associated with a Coordinate Reference System, which may have an arbitrary number of dimensions. However a few specialized classes restrict the CRS to a fixed number of dimensions only. The table below summarizes the most common objects, and list the Java2D classes that are conceptually equivalent.

Purpose	Any dimension	One dimension	Two dimensions	Java2D equivalence
A point in a multi-dimensional space	GeneralDirectPosition	DirectPosition1D	DirectPosition2D	Point2D
A box in a multi-dimensional space	GeneralEnvelope		Envelope2D	Rectangle2D

Envelopes spanning the anti-meridian of a Geographic CRS
The Web Coverage Service (WCS) 1.1 specification uses an extended interpretation of the bounding box definition. In a WCS 1.1 data structure, the lower corner defines the edges region in the directions of decreasing coordinate values in the envelope CRS, while the upper corner defines the edges region in the directions of increasing coordinate values. Those lower and upper corners are usually the algebraic minimum and maximum coordinates respectively, but not always. For example, an envelope crossing the anti-meridian could have a lower corner longitude greater than the upper corner longitude, like the red box below (the green box is the usual case):

As of Geotk 3.20, every envelopes defined in this package support the extended bounding box interpretation: for any dimension, ordinate values such that upper < lower are handled in a special way. This handling is slightly different for two groups of methods:

• In calculation of envelopes spans and median positions (centers) - handled specially only on axes having the WRAPAROUND range meaning
• When checking for containment, intersections or unions - can be handled specially for any axis, in which case the envelope represents an exclusion area instead than an inclusion area.

Since:

1.2

Version:

3.20

Author:

Martin Desruisseaux (IRD, Geomatys)

Module:

referencing/geotk-referencing (download)