Package com.esri.core.geometry
Class Point
java.lang.Object
com.esri.core.geometry.Geometry
com.esri.core.geometry.Point
- All Implemented Interfaces:
Serializable
A Point is a zero-dimensional object that represents a specific (X,Y)
location in a two-dimensional XY-Plane. In case of Geographic Coordinate
Systems, the X coordinate is the longitude and the Y is the latitude.
- See Also:
-
Nested Class Summary
Nested classes/interfaces inherited from class com.esri.core.geometry.Geometry
Geometry.GeometryAccelerationDegree, Geometry.GeometryType, Geometry.Type
-
Field Summary
FieldsModifier and TypeFieldDescriptionprivate double[]
private double
private double
Fields inherited from class com.esri.core.geometry.Geometry
m_description, m_touchFlag
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionprotected void
_assignVertexDescriptionImpl
(VertexDescription newDescription) private void
Sets to a default empty state.void
applyTransformation
(Transformation2D transform) Applies 2D affine transformation in XY plane.void
applyTransformation
(Transformation3D transform) Applies 3D affine transformation.void
Copies this geometry to another geometry of the same type.Creates an instance of an empty geometry of the same type.boolean
Returns TRUE when this geometry has exactly same type, properties, and coordinates as the other geometry.long
Returns an estimate of this object size in bytes.double
getAttributeAsDbl
(int semantics, int ordinate) Returns value of the given vertex attribute's ordinate.int
getAttributeAsInt
(int semantics, int ordinate) Returns value of the given vertex attribute's ordinate.Returns boundary of this geometry.int
Returns the topological dimension of the geometry object based on the geometry's type.int
getID()
Returns the ID of this point.double
getM()
Returns the attribute M of this point.getType()
Returns the geometry type.final double
getX()
Returns the X coordinate of the point.final Point2D
getXY()
Returns XY coordinates of this point.final void
Returns XY coordinates of this point.getXYZ()
Returns XYZ coordinates of the point.final double
getY()
Returns the Y coordinate of this point.double
getZ()
Returns the Z coordinate of this point.int
hashCode()
Returns the hash code for the point.boolean
isEmpty()
IsEmpty returns TRUE when the Geometry object does not contain geometric information beyond its original initialization state.(package private) final boolean
void
queryEnvelope
(Envelope env) Returns the axis aligned bounding box of the geometry.void
Returns tight bbox of the Geometry in X, Y plane.(package private) void
Returns tight bbox of the Geometry in 3D.queryInterval
(int semantics, int ordinate) Returns the min and max attribute values at the ordinate of the Geometry.void
replaceNaNs
(int semantics, double value) Replaces NaNs in the attribute with the given value.void
setAttribute
(int semantics, int ordinate, double value) Sets the value of the attribute.void
setAttribute
(int semantics, int ordinate, int value) void
setEmpty()
Returns the geometry to its original initialization state by releasing all data referenced by the geometry.void
setID
(int id) Sets the ID of this point.void
setM
(double m) Sets the M coordinate of this point.void
setX
(double x) Sets the X coordinate of the point.void
setXY
(double x, double y) Set the X and Y coordinate of the point.final void
Sets the XY coordinates of this point.void
Sets the XYZ coordinates of this point.void
setY
(double y) Sets the Y coordinate of this point.void
setZ
(double z) Sets the Z coordinate of this point.Methods inherited from class com.esri.core.geometry.Geometry
_clone, _getImpl, _touch, addAttribute, addID, addM, addZ, assignVertexDescription, calculateArea2D, calculateLength2D, copy, dropAllAttributes, dropAttribute, estimateMemorySize, getDescription, getDimensionFromType, getStateFlag, hasAttribute, hasID, hasM, hasZ, isArea, isLinear, isMultiPath, isMultiVertex, isPoint, isSegment, mergeVertexDescription, queryLooseEnvelope2D, queryLooseEnvelope3D, toString, vertex_count, writeReplace
-
Field Details
-
m_x
private double m_x -
m_y
private double m_y -
m_attributes
private double[] m_attributes
-
-
Constructor Details
-
Point
public Point()Creates an empty 2D point. -
Point
-
Point
public Point(double x, double y) Creates a 2D Point with specified X and Y coordinates. In case of Geographic Coordinate Systems, the X coordinate is the longitude and the Y is the latitude.- Parameters:
x
- The X coordinate of the new 2D point.y
- The Y coordinate of the new 2D point.
-
Point
-
Point
public Point(double x, double y, double z) Creates a 3D point with specified X, Y and Z coordinates. In case of Geographic Coordinate Systems, the X coordinate is the longitude and the Y is the latitude.- Parameters:
x
- The X coordinate of the new 3D point.y
- The Y coordinate of the new 3D point.z
- The Z coordinate of the new 3D point.
-
-
Method Details
-
getXY
Returns XY coordinates of this point. -
getXY
Returns XY coordinates of this point. -
setXY
Sets the XY coordinates of this point. param pt The point to create the X and Y coordinate from. -
getXYZ
Returns XYZ coordinates of the point. Z will be set to 0 if Z is missing. -
setXYZ
Sets the XYZ coordinates of this point.- Parameters:
pt
- The point to create the XYZ coordinate from.
-
getX
public final double getX()Returns the X coordinate of the point. -
setX
public void setX(double x) Sets the X coordinate of the point.- Parameters:
x
- The X coordinate to be set for this point.
-
getY
public final double getY()Returns the Y coordinate of this point. -
setY
public void setY(double y) Sets the Y coordinate of this point.- Parameters:
y
- The Y coordinate to be set for this point.
-
getZ
public double getZ()Returns the Z coordinate of this point. -
setZ
public void setZ(double z) Sets the Z coordinate of this point.- Parameters:
z
- The Z coordinate to be set for this point.
-
getM
public double getM()Returns the attribute M of this point. -
setM
public void setM(double m) Sets the M coordinate of this point.- Parameters:
m
- The M coordinate to be set for this point.
-
getID
public int getID()Returns the ID of this point. -
setID
public void setID(int id) Sets the ID of this point.- Parameters:
id
- The ID of this point.
-
getAttributeAsDbl
public double getAttributeAsDbl(int semantics, int ordinate) Returns value of the given vertex attribute's ordinate.- Parameters:
semantics
- The attribute semantics.ordinate
- The attribute's ordinate. For example, the Y coordinate of the NORMAL has ordinate of 1.- Returns:
- The ordinate as double value.
-
getAttributeAsInt
public int getAttributeAsInt(int semantics, int ordinate) Returns value of the given vertex attribute's ordinate. The ordinate is always 0 because integer attributes always have one component.- Parameters:
semantics
- The attribute semantics.ordinate
- The attribute's ordinate. For example, the y coordinate of the NORMAL has ordinate of 1.- Returns:
- The ordinate value truncated to a 32 bit integer value.
-
setAttribute
public void setAttribute(int semantics, int ordinate, double value) Sets the value of the attribute.- Parameters:
semantics
- The attribute semantics.ordinate
- The ordinate of the attribute.value
- Is the array to write values to. The attribute type and the number of elements must match the persistence type, as well as the number of components of the attribute.
-
setAttribute
public void setAttribute(int semantics, int ordinate, int value) -
getType
Description copied from class:Geometry
Returns the geometry type. -
getDimension
public int getDimension()Description copied from class:Geometry
Returns the topological dimension of the geometry object based on the geometry's type.Returns 0 for point and multipoint.
Returns 1 for lines and polylines.
Returns 2 for polygons and envelopes
Returns 3 for objects with volume
- Specified by:
getDimension
in classGeometry
- Returns:
- Returns the integer value of the dimension of geometry.
-
estimateMemorySize
public long estimateMemorySize()Description copied from class:Geometry
Returns an estimate of this object size in bytes.This estimate doesn't include the size of the
VertexDescription
object because instances ofVertexDescription
are shared among geometry objects.- Specified by:
estimateMemorySize
in classGeometry
- Returns:
- Returns an estimate of this object size in bytes.
-
setEmpty
public void setEmpty()Description copied from class:Geometry
Returns the geometry to its original initialization state by releasing all data referenced by the geometry. -
_assignVertexDescriptionImpl
- Specified by:
_assignVertexDescriptionImpl
in classGeometry
-
_setToDefault
private void _setToDefault()Sets to a default empty state. -
applyTransformation
Description copied from class:Geometry
Applies 2D affine transformation in XY plane.- Specified by:
applyTransformation
in classGeometry
- Parameters:
transform
- The affine transformation to be applied to this geometry.
-
applyTransformation
Description copied from class:Geometry
Applies 3D affine transformation. Adds Z attribute if it is missing.- Specified by:
applyTransformation
in classGeometry
- Parameters:
transform
- The affine transformation to be applied to this geometry.
-
copyTo
Description copied from class:Geometry
Copies this geometry to another geometry of the same type. The result geometry is an exact copy. -
createInstance
Description copied from class:Geometry
Creates an instance of an empty geometry of the same type.- Specified by:
createInstance
in classGeometry
- Returns:
- The new instance.
-
isEmpty
public boolean isEmpty()Description copied from class:Geometry
IsEmpty returns TRUE when the Geometry object does not contain geometric information beyond its original initialization state. -
isEmptyImpl
final boolean isEmptyImpl() -
queryEnvelope
Description copied from class:Geometry
Returns the axis aligned bounding box of the geometry.- Specified by:
queryEnvelope
in classGeometry
- Parameters:
env
- The envelope to return the result in.
-
queryEnvelope2D
Description copied from class:Geometry
Returns tight bbox of the Geometry in X, Y plane.- Specified by:
queryEnvelope2D
in classGeometry
- Parameters:
env
- The envelope to return the result in.
-
queryEnvelope3D
Description copied from class:Geometry
Returns tight bbox of the Geometry in 3D.- Specified by:
queryEnvelope3D
in classGeometry
- Parameters:
env
- The envelope to return the result in.
-
queryInterval
Description copied from class:Geometry
Returns the min and max attribute values at the ordinate of the Geometry.- Specified by:
queryInterval
in classGeometry
- Parameters:
semantics
- The semantics of the interval.ordinate
- The ordinate of the interval.- Returns:
- The interval.
-
setXY
public void setXY(double x, double y) Set the X and Y coordinate of the point.- Parameters:
x
- X coordinate of the point.y
- Y coordinate of the point.
-
equals
Returns TRUE when this geometry has exactly same type, properties, and coordinates as the other geometry. -
hashCode
public int hashCode()Returns the hash code for the point. -
getBoundary
Description copied from class:Geometry
Returns boundary of this geometry. Polygon and Envelope boundary is a Polyline. For Polyline and Line, the boundary is a Multi_point consisting of path end points. For Multi_point and Point null is returned.- Specified by:
getBoundary
in classGeometry
- Returns:
- The boundary geometry.
-
replaceNaNs
public void replaceNaNs(int semantics, double value) Description copied from class:Geometry
Replaces NaNs in the attribute with the given value. If the geometry is not empty, it adds the attribute if geometry does not have it yet, and replaces the values. If the geometry is empty, it adds the attribute and does not set any values.- Specified by:
replaceNaNs
in classGeometry
- Parameters:
semantics
- The semantics for which to replace the NaNs.value
- The value to replace NaNs with.
-