

PREV CLASS NEXT CLASS  FRAMES NO FRAMES  
SUMMARY: NESTED  FIELD  CONSTR  METHOD  DETAIL: FIELD  CONSTR  METHOD 
java.lang.Object com.esri.arcgis.datasourcesraster.MapPoint
public class MapPoint
Implements interface IMapPoint (a point in map space).
Constructor Summary  

MapPoint()
Constructs a MapPoint using ArcGIS Engine. 

MapPoint(Object obj)
Deprecated. As of ArcGIS 9.2, replaced by normal Java casts. MapPoint theMapPoint = (MapPoint) obj; 
Method Summary  

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. 
boolean 
equals(Object o)
Compare this object with another 
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. 
static String 
getClsid()
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. 
String 
getImageID()
The image ID of this IMapPoint. 
double 
getM()
The measure attribute. 
String 
getMapPointID()
The identification string of this IMapPoint. 
IDoubleArray 
getPointingErrorCovarianceMatrix()
The pointing error covariance matrix that is associated with this IMapPoint. 
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 
isEmpty()
Indicates whether this geometry contains any points. 
void 
project(ISpatialReference newReferenceSystem)
Projects this geometry into a new spatial reference. 
void 
putCoords(double x,
double y)
Sets the X and Y coordinates. 
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 
setEmpty()
Removes all points from this geometry. 
void 
setID(int pointID)
The Point ID attribute. 
void 
setImageID(String pImageID)
The image ID of this IMapPoint. 
void 
setM(double m)
The measure attribute. 
void 
setMapPointID(String pMapPointID)
The identification string of this IMapPoint. 
void 
setPointingErrorCovarianceMatrix(IDoubleArray ppPointingErrCovMatrix)
The pointing error covariance matrix that is associated with this IMapPoint. 
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 
snapToSpatialReference()
Moves points of this geometry so that they can be represented in the precision of the geometry's associated spatial reference system. 
Methods inherited from class java.lang.Object 

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait 
Methods inherited from interface com.esri.arcgis.interop.RemoteObjRef 

getJintegraDispatch, release 
Constructor Detail 

public MapPoint() throws IOException, UnknownHostException
IOException
 if there are interop problems
UnknownHostException
 if there are interop problemspublic MapPoint(Object obj) throws IOException
MapPoint theMapPoint = (MapPoint) obj;
obj
to MapPoint
.
obj
 an object returned from ArcGIS Engine or Server
IOException
 if there are interop problemsMethod Detail 

public static String getClsid()
public boolean equals(Object o)
equals
in class Object
public int hashCode()
hashCode
in class Object
public String getImageID() throws IOException, AutomationException
getImageID
in interface IMapPoint
IOException
 If there are interop problems.
AutomationException
 If the ArcObject component throws an exception.public void setImageID(String pImageID) throws IOException, AutomationException
setImageID
in interface IMapPoint
pImageID
 The pImageID (in)
IOException
 If there are interop problems.
AutomationException
 If the ArcObject component throws an exception.public String getMapPointID() throws IOException, AutomationException
getMapPointID
in interface IMapPoint
IOException
 If there are interop problems.
AutomationException
 If the ArcObject component throws an exception.public void setMapPointID(String pMapPointID) throws IOException, AutomationException
setMapPointID
in interface IMapPoint
pMapPointID
 The pMapPointID (in)
IOException
 If there are interop problems.
AutomationException
 If the ArcObject component throws an exception.public IDoubleArray getPointingErrorCovarianceMatrix() throws IOException, AutomationException
getPointingErrorCovarianceMatrix
in interface IMapPoint
IOException
 If there are interop problems.
AutomationException
 If the ArcObject component throws an exception.public void setPointingErrorCovarianceMatrix(IDoubleArray ppPointingErrCovMatrix) throws IOException, AutomationException
setPointingErrorCovarianceMatrix
in interface IMapPoint
ppPointingErrCovMatrix
 A reference to a com.esri.arcgis.system.IDoubleArray (in)
IOException
 If there are interop problems.
AutomationException
 If the ArcObject component throws an exception.public void queryCoords(double[] x, double[] y) throws IOException, AutomationException
queryCoords
in interface IPoint
x
 The x (out: use single element array)y
 The y (out: use single element array)
IOException
 If there are interop problems.
AutomationException
 If the ArcObject component throws an exception.public void putCoords(double x, double y) throws IOException, AutomationException
putCoords
in interface IPoint
x
 The x (in)y
 The y (in)
IOException
 If there are interop problems.
AutomationException
 If the ArcObject component throws an exception.public double getX() throws IOException, AutomationException
Returns and Sets the X coordinate of the Point. The X coordinate is the horizontal position of the point.
getX
in interface IPoint
IOException
 If there are interop problems.
AutomationException
 If the ArcObject component throws an exception.IPoint.getZ()
,
IPoint.getM()
,
IPoint.getY()
public void setX(double x) throws IOException, AutomationException
setX
in interface IPoint
x
 The x (in)
IOException
 If there are interop problems.
AutomationException
 If the ArcObject component throws an exception.public double getY() throws IOException, AutomationException
Returns and Sets the Y coordinate of the Point. The Y coordinate is the vertical position of the point.
getY
in interface IPoint
IOException
 If there are interop problems.
AutomationException
 If the ArcObject component throws an exception.IPoint.getZ()
,
IPoint.getM()
,
IPoint.getX()
public void setY(double y) throws IOException, AutomationException
setY
in interface IPoint
y
 The y (in)
IOException
 If there are interop problems.
AutomationException
 If the ArcObject component throws an exception.public double getZ() throws IOException, AutomationException
Returns or Sets the Z attribute on the Point. Although the Z attribute refers to the 3Dimensional depth of the point, the point still spatially exists in only 2Dimensions with a Z attribute. Further, the point must be ZAware to make use of the Z attribute.
getZ
in interface IPoint
IOException
 If there are interop problems.
AutomationException
 If the ArcObject component throws an exception.IPoint.getZ()
,
IZAware
,
IPoint.getM()
,
IZCollection
,
IZ
,
IPoint.getX()
,
IPoint.getY()
public void setZ(double z) throws IOException, AutomationException
setZ
in interface IPoint
z
 The z (in)
IOException
 If there are interop problems.
AutomationException
 If the ArcObject component throws an exception.public double getM() throws IOException, AutomationException
Returns or Sets the M attribute on the Point. The M attribute refers to the Point's measure (similar to an address). The point must be MAware to make use of the M attribute.
getM
in interface IPoint
IOException
 If there are interop problems.
AutomationException
 If the ArcObject component throws an exception.IPoint.getZ()
,
IPoint.getM()
,
IMSegmentation
,
IMSegmentation2
,
IMCollection
,
IMAware
,
IPoint.getX()
,
IPoint.getY()
public void setM(double m) throws IOException, AutomationException
setM
in interface IPoint
m
 The m (in)
IOException
 If there are interop problems.
AutomationException
 If the ArcObject component throws an exception.public int getID() throws IOException, AutomationException
Returns or Sets the ID attribute of the Point. The ID attribute is a numeric label, but does not serve any computational purposes. The Point must be PointIDAware to make use of the ID attribute.
IPoint pPoint
pPoint = new Point();
pPoint.putCoords( 100, 100);
IPointIDAware pIDA
pIDA = new IPointIDAwareProxy(pPoint);
pIDA.pointIDAware(true);
pPoint.setID(10);
getID
in interface IPoint
IOException
 If there are interop problems.
AutomationException
 If the ArcObject component throws an exception.public void setID(int pointID) throws IOException, AutomationException
setID
in interface IPoint
pointID
 The pointID (in)
IOException
 If there are interop problems.
AutomationException
 If the ArcObject component throws an exception.public void constrainDistance(double constraintRadius, IPoint anchor) throws IOException, AutomationException
Sets the base Point to a location a specified distance from the input anchor Point along the line between the two points. ConstrainDistance is used by the editor to fix the distance between an anchor point and an input Point. Thus, the input to be created must lie on the circumference defined by the anchor point and the fixed distance radius with the angle determined by the user.
ConstrainDistance
constrainDistance
in interface IPoint
constraintRadius
 The constraintRadius (in)anchor
 A reference to a com.esri.arcgis.geometry.IPoint (in)
IOException
 If there are interop problems.
AutomationException
 If the ArcObject component throws an exception.public void constrainAngle(double constraintAngle, IPoint anchor, boolean allowOpposite) throws IOException, AutomationException
Projects the base Point to to the nearest point on the line defined by an input anchor point and input angle. ConstrainAngle is used by the editor to force a newly created Point to be on the line between a fixed point and a specified angle.
ContrainAngle
constrainAngle
in interface IPoint
constraintAngle
 The constraintAngle (in)anchor
 A reference to a com.esri.arcgis.geometry.IPoint (in)allowOpposite
 The allowOpposite (in)
IOException
 If there are interop problems.
AutomationException
 If the ArcObject component throws an exception.IPoint.constrainDistance(double, com.esri.arcgis.geometry.IPoint)
public int compare(IPoint otherPoint) throws IOException, AutomationException
Compares the location and attributes of the base point with those of the input point to determine a relative ordering of the two points. Compares point properties in the following order: X, Y, M, Z, and ID. Returns 1 if the base point possesses the first greater property, and returns 1 if the input point possesses the first greater property. This method takes the resolution of the spatial reference into account.
The method should not be used in order to determine equality of two points. Use IRelationalOperator::Equals or IClone::IsEqual. At 9.2, this method uses the resolution property of the point's spatial reference in order to determine (x,y) coordinate ordering. At 9.1, an untoleranced (exact) comparison was performed.
compare
in interface IPoint
otherPoint
 A reference to a com.esri.arcgis.geometry.IPoint (in)
IOException
 If there are interop problems.
AutomationException
 If the ArcObject component throws an exception.public int getGeometryType() throws IOException, AutomationException
esriGeometryNull = 0
esriGeometryPoint = 1
esriGeometryMultipoint = 2
esriGeometryPolyline = 3
esriGeometryPolygon = 4
esriGeometryEnvelope = 5
esriGeometryPath = 6
esriGeometryAny = 7
esriGeometryMultiPatch = 9
esriGeometryRing = 11
esriGeometryLine = 13
esriGeometryCircularArc = 14
esriGeometryBezier3Curve = 15
esriGeometryEllipticArc = 16
esriGeometryBag = 17
esriGeometryTriangleStrip = 18
esriGeometryTriangleFan = 19
esriGeometryRay = 20
esriGeometrySphere = 21
getGeometryType
in interface IGeometry
IOException
 If there are interop problems.
AutomationException
 If the ArcObject component throws an exception.public int getDimension() throws IOException, AutomationException
Returns the dimension of the geometry object based on the geometry's type.
getDimension
in interface IGeometry
IOException
 If there are interop problems.
AutomationException
 If the ArcObject component throws an exception.public ISpatialReference getSpatialReference() throws IOException, AutomationException
Returns and sets the Spatial Reference in which the geometry exists. If the spatial reference has not been set the property will return an empty ISpatialReference instance.
getSpatialReference
in interface IGeometry
IOException
 If there are interop problems.
AutomationException
 If the ArcObject component throws an exception.public void setSpatialReferenceByRef(ISpatialReference spatialRef) throws IOException, AutomationException
setSpatialReferenceByRef
in interface IGeometry
spatialRef
 A reference to a com.esri.arcgis.geometry.ISpatialReference (in)
IOException
 If there are interop problems.
AutomationException
 If the ArcObject component throws an exception.public boolean isEmpty() throws IOException, AutomationException
IsEmpty returns TRUE when the Geometry object does not contain geometric information beyond its original initialization state. An object may be returned to its original initialization (IsEmpty = TRUE) state using SetEmpty.
isEmpty
in interface IGeometry
IOException
 If there are interop problems.
AutomationException
 If the ArcObject component throws an exception.public void setEmpty() throws IOException, AutomationException
SetEmpty returns the Geometry to its original initialization state by releasing all data referenced by the Geometry.
setEmpty
in interface IGeometry
IOException
 If there are interop problems.
AutomationException
 If the ArcObject component throws an exception.public void queryEnvelope(IEnvelope outEnvelope) throws IOException, AutomationException
Returns the unique Envelope that binds the Geometry object. This is the smallest Envelope that Contains the object.
Note: The output geometry must be cocreated prior to the query. The output geometry is not cocreated by the method; it is populated. This can be used in performance critical situations. For example, creating the geometry only once outside a loop and use the query method could improve performance.
queryEnvelope
in interface IGeometry
outEnvelope
 A reference to a com.esri.arcgis.geometry.IEnvelope (in)
IOException
 If there are interop problems.
AutomationException
 If the ArcObject component throws an exception.public IEnvelope getEnvelope() throws IOException, AutomationException
Returns the unique Envelope that binds the Geometry object. This is the smallest Envelope that Contains the object.
getEnvelope
in interface IGeometry
IOException
 If there are interop problems.
AutomationException
 If the ArcObject component throws an exception.public void project(ISpatialReference newReferenceSystem) throws IOException, AutomationException
To Project, the geometry needs to have a Spatial Reference set, and not have an UnknownCoordinateSystem. The new spatial reference system passed to the method defines the output coordinate system. If either spatial reference is Unknown, the coordinates are not changed. The Z and measure values are not changed by the Project method.
A geometry is not densified before it is projected. This can lead to the output geometries not reflecting the 'true' shape in the new coordinate system. A straight line in one coordinate system is not necessarily a straight line in a different coordinate system. Use IGeometry2::ProjectEx if you want to densify the geometries while they are projected.
The Project method must be applied on highlevel geometries only. HighLevel geometries are point, multipoint, polyline and polygon. To use this method with lowlevel geometries such as segments (Line, Circular Arc, Elliptic Arc, Bézier Curve), paths or rings, they must be wrapped into highlevel geometry types.
If a geometry is projected to a projected coordinate system that can't represent the geographic area where the geometry is located (or if trying to move an xy coordinate from outside the projected coordinate system back into geographic), the geometry will be set to empty.
Note: This method can only be called upon the top level geometries (Points, Multipoints, Polylines and Polygons). If the from/to spatial references have different geographic coordinate systems, the Project method looks for a GeoTransformationsOperationSet. If the set of Geotransformations is present in memory, Project will use it to perform a geographic/datum Transformation. To use a specific geotransformation, use the IGeometry2::ProjectEx method.
project
in interface IGeometry
newReferenceSystem
 A reference to a com.esri.arcgis.geometry.ISpatialReference (in)
IOException
 If there are interop problems.
AutomationException
 If the ArcObject component throws an exception.public void snapToSpatialReference() throws IOException, AutomationException
snapToSpatialReference
in interface IGeometry
IOException
 If there are interop problems.
AutomationException
 If the ArcObject component throws an exception.public void geoNormalize() throws IOException, AutomationException
geoNormalize
in interface IGeometry
IOException
 If there are interop problems.
AutomationException
 If the ArcObject component throws an exception.public void geoNormalizeFromLongitude(double longitude) throws IOException, AutomationException
geoNormalizeFromLongitude
in interface IGeometry
longitude
 The longitude (in)
IOException
 If there are interop problems.
AutomationException
 If the ArcObject component throws an exception.


PREV CLASS NEXT CLASS  FRAMES NO FRAMES  
SUMMARY: NESTED  FIELD  CONSTR  METHOD  DETAIL: FIELD  CONSTR  METHOD 