com.vividsolutions.jts.geom
Class Coordinate
java.lang.Object
com.vividsolutions.jts.geom.Coordinate
- Cloneable, Comparable, Serializable
public class Coordinate
extends java.lang.Object
implements Comparable, Cloneable, Serializable
A lightweight class used to store coordinates
on the 2-dimensional Cartesian plane.
It is distinct from
Point
, which is a subclass of
Geometry
. Unlike objects of type
Point
(which contain additional
information such as an envelope, a precision model, and spatial reference
system information), a
Coordinate
only contains ordinate values
and accessor methods.
Coordinate
s are two-dimensional points, with an additional
z-ordinate. JTS does not support any operations on the z-ordinate except
the basic accessor functions. Constructed coordinates will have a
z-ordinate of
NaN
. The standard comparison functions will ignore
the z-ordinate.
double | x - The x-coordinate.
|
double | y - The y-coordinate.
|
double | z - The z-coordinate.
|
Coordinate() - Constructs a
Coordinate at (0,0,NaN).
|
Coordinate(Coordinate c) - Constructs a
Coordinate having the same (x,y,z) values as
other .
|
Coordinate(double x, double y) - Constructs a
Coordinate at (x,y,NaN).
|
Coordinate(double x, double y, double z) - Constructs a
Coordinate at (x,y,z).
|
Object | clone()
|
int | compareTo(Object o) - Compares this object with the specified object for order.
|
double | distance(Coordinate p) - "Fixes" this Coordinate to the PrecisionModel grid.
|
boolean | equals(Object other) - Returns
true if other has the same values for
the x and y ordinates.
|
boolean | equals2D(Coordinate other) - Returns whether the planar projections of the two
Coordinate s
are equal.
|
boolean | equals3D(Coordinate other) - Returns
true if other has the same values for x,
y and z.
|
int | hashCode()
|
static int | hashCode(double x) - Returns a hash code for a double value, using the algorithm from
Joshua Bloch's book Effective Java"
|
void | setCoordinate(Coordinate other) - Sets this
Coordinate s (x,y,z) values to that of other
.
|
String | toString() - Returns a
String of the form (x,y,z) .
|
x
public double x
The x-coordinate.
y
public double y
The y-coordinate.
z
public double z
The z-coordinate.
Coordinate
public Coordinate()
Constructs a Coordinate
at (0,0,NaN).
Coordinate
public Coordinate(Coordinate c)
Constructs a Coordinate
having the same (x,y,z) values as
other
.
c
- the Coordinate
to copy.
Coordinate
public Coordinate(double x,
double y)
Constructs a Coordinate
at (x,y,NaN).
x
- the x-valuey
- the y-value
Coordinate
public Coordinate(double x,
double y,
double z)
Constructs a Coordinate
at (x,y,z).
x
- the x-valuey
- the y-valuez
- the z-value
clone
public Object clone()
compareTo
public int compareTo(Object o)
Compares this object with the specified object for order.
Since Coordinates are 2.5D, this routine ignores the z value when making the comparison.
Returns
- -1 : this.x <32other.x || ((this.x == other.x) && (this.y <13
other.y))
- 0 : this.x == other.x && this.y = other.y
- 1 : this.x > other.x || ((this.x == other.x) && (this.y > other.y))
o
- the Coordinate
with which this Coordinate
is being compared
- a negative integer, zero, or a positive integer as this
Coordinate
is less than, equal to, or greater than the specified Coordinate
distance
public double distance(Coordinate p)
"Fixes" this Coordinate to the PrecisionModel grid.
equals
public boolean equals(Object other)
Returns true
if other
has the same values for
the x and y ordinates.
Since Coordinates are 2.5D, this routine ignores the z value when making the comparison.
other
- a Coordinate
with which to do the comparison.
true
if other
is a Coordinate
with the same values for the x and y ordinates.
equals2D
public boolean equals2D(Coordinate other)
Returns whether the planar projections of the two Coordinate
s
are equal.
other
- a Coordinate
with which to do the 2D comparison.
true
if the x- and y-coordinates are equal; the
z-coordinates do not have to be equal.
equals3D
public boolean equals3D(Coordinate other)
Returns true
if other
has the same values for x,
y and z.
other
- a Coordinate
with which to do the 3D comparison.
true
if other
is a Coordinate
with the same values for x, y and z.
hashCode
public int hashCode()
hashCode
public static int hashCode(double x)
Returns a hash code for a double value, using the algorithm from
Joshua Bloch's book Effective Java"
setCoordinate
public void setCoordinate(Coordinate other)
Sets this Coordinate
s (x,y,z) values to that of other
.
other
- the Coordinate
to copy
toString
public String toString()
Returns a String
of the form (x,y,z) .
- a
String
of the form (x,y,z)