|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
The internal representation of a list of coordinates inside a Geometry.
There are some cases in which you might want Geometries to store their points using something other than the JTS Coordinate class. For example, you may want to experiment with another implementation, such as an array of x's and an array of y's. Or you might want to use your own coordinate class, one that supports extra attributes like M-values.
You can do this by implementing the CoordinateSequence and CoordinateSequenceFactory interfaces. You would then create a GeometryFactory parameterized by your CoordinateSequenceFactory, and use this GeometryFactory to create new Geometries. All of these new Geometries will use your CoordinateSequence implementation.
For an example, see the code for
com.vividsolutions.jtsexample.geom.TwoArrayCoordinateSequenceExample
.
DefaultCoordinateSequenceFactory
,
TwoArrayCoordinateSequenceFactory
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 |
public static final int X
public static final int Y
public static final int Z
public static final int M
Method Detail |
public int getDimension()
public 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
public Coordinate getCoordinateCopy(int i)
i
- the index of the coordinate to retrieve
public 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 valuepublic double getX(int index)
index
-
public double getY(int index)
index
-
public double getOrdinate(int index, int ordinateIndex)
index
- the coordinate index in the sequenceordinateIndex
- the ordinate index in the coordinate (in range [0, dimension-1])public int size()
public 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 valuepublic Coordinate[] toCoordinateArray()
public 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
public java.lang.Object clone()
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |