Point (ArcObjects Java API)

Overview

Package

Class

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

com.esri.arcgis.geometry
Class Point

java.lang.Object
  com.esri.arcgis.geometry.Point

All Implemented Interfaces:: IClone, IConstructPoint, IConstructPoint2, IConversionMGRS, IGeometry, IGeometry2, IGeometry3, IGeometry4, IGeometry5, IHitTest, IMAware, IMSnap, IPersist, IPersistStream, IPoint, IPointIDAware, IProximityOperator, IRelationalOperator, ISupportErrorInfo, ITopologicalOperator, ITransform2D, ITransform3D, IXMLSerialize, IZAware, java.io.Serializable

public class Point
extends java.lang.Object
implements IPoint, IMAware, IZAware, IPointIDAware, IGeometry, IGeometry2, IGeometry3, IGeometry4, IGeometry5, ITransform2D, ITransform3D, IConstructPoint, IConstructPoint2, IRelationalOperator, IProximityOperator, ITopologicalOperator, IHitTest, ISupportErrorInfo, IPersist, IPersistStream, IClone, IXMLSerialize, IConversionMGRS, IMSnap

An two dimensional point, optionally with measure, height, and ID attributes.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

See Also:: Serialized Form

Constructor Summary
`Point()` Constructs a Point using ArcGIS Engine.
`Point(java.lang.Object obj)` Deprecated. As of ArcGIS 9.2, replaced by normal Java casts.

Method Summary
`void`	`assign(IClone src)` Assigns the properties of src to the receiver.
`IGeometry`	`buffer(double distance)` Constructs a polygon that is the locus of points at a distance less than or equal to a specified distance from this geometry.
`void`	`clip(IEnvelope clipperEnvelope)` Constructs the intersection of this geometry and the specified envelope.
`void`	`clipDense(IEnvelope clipperEnvelope, double denseDistance)` Constructs the intersection of this geometry and the specified envelope; densifies lines in output contributed by the clipping envelope.
`int`	`compare(IPoint otherPoint)` Compares X, Y, M, Z, ID of this point (in that order) with that of the other point.
`void`	`constrainAngle(double constraintAngle, IPoint anchor, boolean allowOpposite)` Projects this point to the point on the infinite line defined by anchor and angle (in radians).
`void`	`constrainDistance(double constraintRadius, IPoint anchor)` Projects this point to the perimeter of the circle defined by radius and anchor.
`void`	`constructAlong(ICurve curve, int extension, double distance, boolean asRatio)` Constructs a point distance units along the input curve.
`void`	`constructAngleBisector(IPoint from, IPoint through, IPoint to, double distance, boolean useAcuteAngle)` Constructs a point on the bisector of the angle (from, through, to).
`void`	`constructAngleDistance(IPoint p, double inAngle, double distance)` Constructs a point at a specified angle (in radians) from the horizontal axis and a specified distance away from the input point.
`void`	`constructAngleIntersection(IPoint p1, double angle1, IPoint p2, double angle2)` Constructs the point of intersection between two lines defined by the input points and angles (in radians).
`void`	`constructAverage(IPointCollection points, int attributeType)` Constructs the geometric average of the input point collection.
`void`	`constructDeflection(ILine baseLine, double distance, double inAngle)` Constructs a point in the polar coordinate system defined by baseLine and its 'from' point.
`void`	`constructDeflectionIntersection(ILine baseLine, double startAngle, double endAngle, boolean onRightSide)` Constructs the point of intersection of two rays with origins at the endpoints of the base line and the specified angles (in radians).
`void`	`constructOffset(ICurve curve, int extension, double distance, boolean asRatio, double offset)` Constructs a point distance units along the input curve and offset units perpendicularly away from it.
`void`	`constructParallel(ISegment segment, int extension, IPoint start, double distance)` Constructs a point distance units from start, parallel to the tangent at the point nearest to start on the (extended) segment.
`void`	`constructPerpendicular(ISegment base, int extension, IPoint p, double distance, boolean bUseLineOrientation)` Constructs a point 'distance' units from p and lying along the line normal to base and passing through p.
`void`	`constructThreePointResection(IPoint point1, double angleP1P2, IPoint point2, double angleP2P3, IPoint point3, double[] arcAngle)` Constructs the point of observation from which two signed angles between three points were measured; returns an angle which can help establish the confidence of the observation location: A small angle indicates greater uncertainty in the location.
`void`	`constructUnion(IEnumGeometry geometries)` Defines this geometry to be the union of the inputs.
`boolean`	`contains(IGeometry other)` Indicates if this geometry contains the other geometry.
`IGeometry`	`convexHull()` Constructs the convex hull of this geometry.
`java.lang.String`	`createMGRS(int numDigits, boolean round, int mode)` Returns the MGRS/USNG description of a point.
`boolean`	`crosses(IGeometry other)` Indicates if the two geometries intersect in a geometry of lesser dimension.
`void`	`cut(IPolyline cutter, IGeometry[] leftGeom, IGeometry[] rightGeom)` Splits this geometry into a part left of the cutting polyline, and a part right of it.
`void`	`deserialize(IXMLSerializeData data)` Deserializes an object from XML.
`IGeometry`	`difference(IGeometry other)` Constructs the geometry containing points from this geometry but not the other geometry.
`boolean`	`disjoint(IGeometry other)` Indicates if the two geometries share no points in common.
`void`	`dropMs()` Sets all the M values to a non-valid number (NaN).
`void`	`dropPointIDs()` Unsets all PointID values without changing awareness.
`void`	`dropZs()` Sets all the Z values to a non-valid number (NaN).
`boolean`	`equals(java.lang.Object o)` Compare this object with another
`IClone`	`esri_clone()` Clones the receiver and assigns the result to *clone.
`boolean`	`esri_equals(IGeometry other)` Indicates if the two geometries are of the same type and define the same set of points in the plane.
`void`	`geoNormalize()` Shifts longitudes, if need be, into a continuous range of 360 degrees.
`void`	`geoNormalizeFromLongitude(double longitude)` Normalizes longitudes into a continuous range containing the longitude.
`IClone`	`getAsIClone()` Deprecated. No replacement. The object reference can be directly used where the implemented interface is needed.
`IConstructPoint`	`getAsIConstructPoint()` Deprecated. No replacement. The object reference can be directly used where the implemented interface is needed.
`IConstructPoint2`	`getAsIConstructPoint2()` Deprecated. No replacement. The object reference can be directly used where the implemented interface is needed.
`IConversionMGRS`	`getAsIConversionMGRS()` Deprecated. No replacement. The object reference can be directly used where the implemented interface is needed.
`IGeometry`	`getAsIGeometry()` Deprecated. No replacement. The object reference can be directly used where the implemented interface is needed.
`IGeometry2`	`getAsIGeometry2()` Deprecated. No replacement. The object reference can be directly used where the implemented interface is needed.
`IGeometry3`	`getAsIGeometry3()` Deprecated. No replacement. The object reference can be directly used where the implemented interface is needed.
`IGeometry4`	`getAsIGeometry4()` Deprecated. No replacement. The object reference can be directly used where the implemented interface is needed.
`IGeometry5`	`getAsIGeometry5()` Deprecated. No replacement. The object reference can be directly used where the implemented interface is needed.
`IHitTest`	`getAsIHitTest()` Deprecated. No replacement. The object reference can be directly used where the implemented interface is needed.
`IMAware`	`getAsIMAware()` Deprecated. No replacement. The object reference can be directly used where the implemented interface is needed.
`IMSnap`	`getAsIMSnap()` Deprecated. No replacement. The object reference can be directly used where the implemented interface is needed.
`IPersist`	`getAsIPersist()` Deprecated. No replacement. The object reference can be directly used where the implemented interface is needed.
`IPersistStream`	`getAsIPersistStream()` Deprecated. No replacement. The object reference can be directly used where the implemented interface is needed.
`IPoint`	`getAsIPoint()` Deprecated. No replacement. The object reference can be directly used where the implemented interface is needed.
`IPointIDAware`	`getAsIPointIDAware()` Deprecated. No replacement. The object reference can be directly used where the implemented interface is needed.
`IProximityOperator`	`getAsIProximityOperator()` Deprecated. No replacement. The object reference can be directly used where the implemented interface is needed.
`IRelationalOperator`	`getAsIRelationalOperator()` Deprecated. No replacement. The object reference can be directly used where the implemented interface is needed.
`ISupportErrorInfo`	`getAsISupportErrorInfo()` Deprecated. No replacement. The object reference can be directly used where the implemented interface is needed.
`ITopologicalOperator`	`getAsITopologicalOperator()` Deprecated. No replacement. The object reference can be directly used where the implemented interface is needed.
`ITransform2D`	`getAsITransform2D()` Deprecated. No replacement. The object reference can be directly used where the implemented interface is needed.
`ITransform3D`	`getAsITransform3D()` Deprecated. No replacement. The object reference can be directly used where the implemented interface is needed.
`IXMLSerialize`	`getAsIXMLSerialize()` Deprecated. No replacement. The object reference can be directly used where the implemented interface is needed.
`IZAware`	`getAsIZAware()` Deprecated. No replacement. The object reference can be directly used where the implemented interface is needed.
`IGeometry`	`getBoundary()` The boundary of this geometry.
`IPoint`	`getCentroidEx()` The center of gravity (centroid).
`void`	`getClassID(GUID[] pClassID)` Supported Platforms
`static java.lang.String`	`getClsid()`
`int`	`getDimension()` The topological dimension of this geometry.
`IEnvelope`	`getEnvelope()` Creates a copy of this geometry's envelope and returns it.
`int`	`getGeometryType()` The type of this geometry.
`int`	`getID()` The Point ID attribute.
`double`	`getM()` The measure attribute.
`void`	`getSizeMax(_ULARGE_INTEGER[] pcbSize)` Supported Platforms
`ISpatialReference`	`getSpatialReference()` The spatial reference associated with this geometry.
`double`	`getX()` The X coordinate.
`double`	`getY()` The Y coordinate.
`double`	`getZ()` The Z attribute.
`int`	`hashCode()` the hashcode for this object
`boolean`	`hitTest(IPoint queryPoint, double searchRadius, int geometryPart, IPoint hitPoint, double[] hitDistance, int[] hitPartIndex, int[] hitSegmentIndex, boolean[] bRightSide)` Locates a part of a geometry closest to a query point.
`void`	`interfaceSupportsErrorInfo(GUID riid)` Supported Platforms
`IGeometry`	`intersect(IGeometry other, int resultDimension)` Constructs the geometry that is the set-theoretic intersection of the input geometries.
`boolean`	`isChanged()` Indicates if a geometry has been changed (edited, projected, etc).
`void`	`isDirty()` Supported Platforms
`boolean`	`isEmpty()` Indicates whether this geometry contains any points.
`boolean`	`isEqual(IClone other)` Returns TRUE when the receiver and other have the same properties.
`boolean`	`isIdentical(IClone other)` Returns TRUE when the receiver and other are the same object.
`boolean`	`isKnownSimple()` Indicates whether this geometry is known (or assumed) to be topologically correct.
`boolean`	`isMAware()` Indicates whether or not the geometry is aware of and capable of handling Ms.
`boolean`	`isMSimple()` Indicates if all the Ms are valid numbers.
`boolean`	`isPointIDAware()` Indicates whether or not the geometry is aware of and capable of handling PointIDs.
`boolean`	`isPointIDSimple()` Indicates if all PointID values for this geometry are well-defined.
`boolean`	`isSimple()` Indicates whether this geometry is known (or assumed) to be topologically correct, after explicitly determining this if the geometry is not already known (or assumed) to be simple.
`boolean`	`isZAware()` Indicates whether or not the geometry is aware of and capable of handling Zs.
`boolean`	`isZSimple()` Indicates if all the Zs are valid numbers.
`void`	`load(IStream pstm)` Supported Platforms
`void`	`move(double dx, double dy)` Moves dx units horizontally and dy units vertically.
`void`	`move3D(double dx, double dy, double dz)` Moves the object by dx, dy and dz along the x, y, and z axes respectively.
`void`	`moveVector(ILine v)` Moves a direction and distance v.
`void`	`moveVector3D(IVector3D v)` Not currently implemented.
`boolean`	`overlaps(IGeometry other)` Indicates if the intersection of the two geometries has the same dimension as one of the input geometries.
`void`	`project(ISpatialReference newReferenceSystem)` Projects this geometry into a new spatial reference.
`void`	`project5(ISpatialReference newSpatialReference, int projectionHint)` Same as Project, but with additional parameter projectionHint.
`void`	`projectEx(ISpatialReference newReferenceSystem, int direction, IGeoTransformation geoTransformation, boolean bAngularDensify, double maxSegmentLength, double maxDeviation)` Projects a geometry, optionally applies a GeoTransformation, and optionally densifies the geometry.
`void`	`projectEx5(ISpatialReference newReferenceSystem, int direction, ITransformation transformation, boolean bAngularDensify, double maxSegmentLength, double maxDeviation, int projectionHint)` Same as ProjectEx, but with additional parameter projectionHint.
`IGeometry`	`projectToPlane(IPoint planarOrigin, IVector3D planarPositiveX, IVector3D planarNorm)` Generates a polygon footprint for the object in an arbitrary plane.
`void`	`putCoords(double x, double y)` Sets the X and Y coordinates.
`void`	`putCoordsFromMGRS(java.lang.String mgrs, int mode)` Creates the coordinates of a point from the MGRS/USNG description.
`void`	`queryClipped(IEnvelope clipperEnvelope, IGeometry clippedGeometry)` Redefines clippedGeometry to be the intersection of this geometry and the clipping envelope.
`void`	`queryClippedDense(IEnvelope clipperEnvelope, double denseDistance, IGeometry clippedGeometry)` Redefines clippedGeometry to be the intersection of this geometry and the clipping envelope; densifies lines in the output contributed by the clipping envelope.
`void`	`queryCoords(double[] x, double[] y)` Returns the X and Y coordinates.
`void`	`queryEnvelope(IEnvelope outEnvelope)` Copies this geometry's envelope properties into the specified envelope.
`void`	`queryNearestPoint(IPoint p, int extension, IPoint nearest)` Copies into 'nearest' a point on this geometry nearest to the input point.
`void`	`queryWKSEnvelope(_WKSEnvelope e)` Defines the specified wksenvelope to be the current extent of this geometry in the x-y plane.
`boolean`	`relation(IGeometry other, java.lang.String relationDescription)` Indicates if the defined relationship exists.
`double`	`returnDistance(IGeometry other)` Returns the minimum distance between two geometries.
`IPoint`	`returnNearestPoint(IPoint p, int extension)` Creates and returns a point on this geometry nearest to the input point.
`void`	`rotate(IPoint origin, double rotationAngle)` Rotates about the specified origin point.
`void`	`rotateVector3D(IVector3D axis, double rotationAngle)` Not currently implemented.
`void`	`save(IStream pstm, int fClearDirty)` Supported Platforms
`void`	`scale(IPoint origin, double sx, double sy)` Scales about the specified origin using seperate horizonal and vertical scales.
`void`	`scale3D(IPoint origin, double sx, double sy, double sz)` Not currently implemented.
`void`	`serialize(IXMLSerializeData data)` Serializes an object to XML.
`void`	`setChanged(boolean isChanged)` Indicates if a geometry has been changed (edited, projected, etc).
`void`	`setEmpty()` Removes all points from this geometry.
`void`	`setID(int pointID)` The Point ID attribute.
`void`	`setM(double m)` The measure attribute.
`void`	`setMAware(boolean mAware)` Indicates whether or not the geometry is aware of and capable of handling Ms.
`void`	`setPointIDAware(boolean idAware)` Indicates whether or not the geometry is aware of and capable of handling PointIDs.
`void`	`setSpatialReferenceByRef(ISpatialReference spatialRef)` The spatial reference associated with this geometry.
`void`	`setX(double x)` The X coordinate.
`void`	`setY(double y)` The Y coordinate.
`void`	`setZ(double z)` The Z attribute.
`void`	`setZAware(boolean zAware)` Indicates whether or not the geometry is aware of and capable of handling Zs.
`void`	`simplify()` Makes this geometry topologically correct.
`void`	`snap()` Snaps ms to the precision of the spatial reference associated with the geometry.
`void`	`snapToSpatialReference()` Moves points of this geometry so that they can be represented in the precision of the geometry's associated spatial reference system.
`IGeometry`	`symmetricDifference(IGeometry other)` Constructs the geometry that contains points from either but not both input geometries.
`boolean`	`touches(IGeometry other)` Indicates if the boundaries of the geometries intersect.
`void`	`transform(int direction, ITransformation transformation)` Applies an arbitrary transformation.
`void`	`transform3D(int direction, ITransformation3D transformation)` Not currently implemented.
`IGeometry`	`union(IGeometry other)` Constructs the geometry that is the set-theoretic union of the input geometries.
`boolean`	`within(IGeometry other)` Indicates if this geometry is contained (is within) another geometry.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Point

public Point()
      throws java.io.IOException,
             java.net.UnknownHostException

Constructs a Point using ArcGIS Engine.
Throws:: java.io.IOException - if there are interop problems; java.net.UnknownHostException - if there are interop problems

Point

public Point(java.lang.Object obj)
      throws java.io.IOException

Deprecated. As of ArcGIS 9.2, replaced by normal Java casts.; Construct a Point using a reference to such an object returned from ArcGIS Engine or Server. This is semantically equivalent to casting obj to Point.
Point thePoint = (Point) obj;
Parameters:: obj - an object returned from ArcGIS Engine or Server
Throws:: java.io.IOException - if there are interop problems

Method Detail