|
JTS Topology Suite version 1.12 | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface CoordinateSequence
The internal representation of a list of coordinates inside a Geometry.
This allows Geometries to store their
points using something other than the JTS Coordinate
class.
For example, a storage-efficient implementation
might store coordinate sequences as an array of x's
and an array of y's.
Or a custom coordinate class might support extra attributes like M-values.
Implementing a custom coordinate storage structure
requires implementing the CoordinateSequence
and
CoordinateSequenceFactory
interfaces.
To use the custom CoordinateSequence, create a
new GeometryFactory
parameterized by the CoordinateSequenceFactory
The GeometryFactory
can then be used to create new Geometry
s.
The new Geometries
will use the custom CoordinateSequence implementation.
For an example, see the code for
ExtendedCoordinateExample
.
CoordinateArraySequenceFactory
,
PackedCoordinateSequenceFactory
,
ExtendedCoordinateExample
Field Summary | |
---|---|
static int |
M
|
static int |
X
Standard ordinate index values |
static int |
Y
|
static int |
Z
|
Method Summary | |
---|---|
java.lang.Object |
clone()
Returns a deep copy of this collection. |
Envelope |
expandEnvelope(Envelope env)
Expands the given Envelope to include the coordinates in the sequence. |
Coordinate |
getCoordinate(int i)
Returns (possibly a copy of) the i'th coordinate in this sequence. |
void |
getCoordinate(int index,
Coordinate coord)
Copies the i'th coordinate in the sequence to the supplied Coordinate . |
Coordinate |
getCoordinateCopy(int i)
Returns a copy of the i'th coordinate in this sequence. |
int |
getDimension()
Returns the dimension (number of ordinates in each coordinate) for this sequence. |
double |
getOrdinate(int index,
int ordinateIndex)
Returns the ordinate of a coordinate in this sequence. |
double |
getX(int index)
Returns ordinate X (0) of the specified coordinate. |
double |
getY(int index)
Returns ordinate Y (1) of the specified coordinate. |
void |
setOrdinate(int index,
int ordinateIndex,
double value)
Sets the value for a given ordinate of a coordinate in this sequence. |
int |
size()
Returns the number of coordinates in this sequence. |
Coordinate[] |
toCoordinateArray()
Returns (possibly copies of) the Coordinates in this collection. |
Field Detail |
---|
static final int X
static final int Y
static final int Z
static final int M
Method Detail |
---|
int getDimension()
Coordinate getCoordinate(int i)
Note that in the future the semantics of this method may change to guarantee that the Coordinate returned is always a copy. Callers should not to assume that they can modify a CoordinateSequence by modifying the object returned by this method.
i
- the index of the coordinate to retrieve
Coordinate getCoordinateCopy(int i)
i
- the index of the coordinate to retrieve
void getCoordinate(int index, Coordinate coord)
Coordinate
. Only the first two dimensions are copied.
index
- the index of the coordinate to copycoord
- a Coordinate
to receive the valuedouble getX(int index)
index
-
double getY(int index)
index
-
double getOrdinate(int index, int ordinateIndex)
index
- the coordinate index in the sequenceordinateIndex
- the ordinate index in the coordinate (in range [0, dimension-1])int size()
void setOrdinate(int index, int ordinateIndex, double value)
index
- the coordinate index in the sequenceordinateIndex
- the ordinate index in the coordinate (in range [0, dimension-1])value
- the new ordinate valueCoordinate[] toCoordinateArray()
Envelope expandEnvelope(Envelope env)
Envelope
to include the coordinates in the sequence.
Allows implementing classes to optimize access to coordinate values.
env
- the envelope to expand
java.lang.Object clone()
|
JTS Topology Suite version 1.12 | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |