Provides access to members that find the 3D distance between two geometries with Zs.
Description
This interface is new at ArcGIS 9.3.
Returns the point on the input geometry that is closest to the input point, and returns the 3D distance between these two points. In contrast to IProximityOperator, Z values are taken into account when determining whether the given relationship exists.
Members
| Name | Description | |
|---|---|---|
 |
QueryNearestPoint3D | Copies into 'nearest' a point on this geometry nearest to the input point. |
|
ReturnDistance3D | Returns the minimal distance between two geometries. |
|
ReturnNearestPoint3D | Creates and returns a point on this geometry nearest to the input point. |
IProximityOperator3D.QueryNearestPoint3D Method
Copies into 'nearest' a point on this geometry nearest to the input point.
Public Sub QueryNearestPoint3D ( _
ByVal pInP As IPoint, _
ByVal extension As esriSegmentExtension, _
ByVal pNearest As IPoint _
)
public void QueryNearestPoint3D (
IPoint pInP,
esriSegmentExtension extension,
IPoint pNearest
);
Description
Queries the nearest point on a z aware geometry to the input point in 3D space. Depending on the method of segment extension, the nearest point can also be found on an extension of the geometry.
Remarks
If the geometry is an Envelope and the input point is located within the bounds of the Envelope, QueryNearestPoint3D will return a point on the exterior of the Envelope nearest the input point.
public static void QueryNearestPoint3D()
{
IGeometry pointGeometry = GetPointGeometry();
IGeometry envelopeGeometry = GetEnvelopeGeometry();
IProximityOperator3DÂ proximityOperator3D = envelopeGeometry as IProximityOperator3D;
IPoint nearestPoint3D = new PointClass();
proximityOperator3D.QueryNearestPoint3D(pointGeometry as IPoint, esriSegmentExtension.esriNoExtension, nearestPoint3D);
//nearestPoint3D =Â (5.393, -0.583, -6.043)
}
IProximityOperator3D.ReturnDistance3D Method
Returns the minimal distance between two geometries.
Public Function ReturnDistance3D ( _
ByVal pOther As IGeometry _
) As Double
public double ReturnDistance3D (
IGeometry pOther
);
Description
Returns the minimum distance between two z aware geometries in 3D space. If the geometries intersect, the minimum distance is 0. Only returns the distance, and not the nearest points.
public static void ReturnDistance3D()
{
IGeometry pointGeometry = GetPointGeometry();
IGeometry envelopeGeometry = GetEnvelopeGeometry();
IProximityOperator3D proximityOperator3D = envelopeGeometry as IProximityOperator3D;
double distance3D = proximityOperator3D.ReturnDistance3D(pointGeometry);
//distance3D = 13.971
}
IProximityOperator3D.ReturnNearestPoint3D Method
Creates and returns a point on this geometry nearest to the input point.
Public Function ReturnNearestPoint3D ( _
ByVal pInP As IPoint, _
ByVal extension As esriSegmentExtension _
) As IPoint
public IPoint ReturnNearestPoint3D (
IPoint pInP,
esriSegmentExtension extension
);
Description
Finds and returns the nearest point, in 3D space, on a z aware geometry to the input point. Depending on the method of segment extension, the nearest point can also be found on an extension of the geometry.
Remarks
If the geometry is an Envelope and the input point is located within the bounds of the Envelope, QueryNearestPoint3D will return a point on the exterior of the Envelope nearest the input point.
public static void ReturnNearestPoint3D()
{
IGeometry pointGeometry = GetPointGeometry();
IGeometry envelopeGeometry = GetEnvelopeGeometry();
IProximityOperator3D proximityOperator3D = envelopeGeometry as IProximityOperator3D;
IPoint nearestPoint3D = proximityOperator3D.ReturnNearestPoint3D(pointGeometry as IPoint, esriSegmentExtension.esriNoExtension);
//nearestPoint3D = (5.393, -0.583, -6.043)
}
Classes that implement IProximityOperator3D
| Classes | Description |
|---|---|
| Envelope | A rectangle with sides parallel to a coordinate system defining the extent of another geometry; optionally has min and max measure, height and ID attributes. |
| Line | A 2D straight line between a pair of 2D endpoints; can optionally have height, measure and ID attributes at each endpoint. |
| MultiPatch | A collection of surface patches. |
| Multipoint | An ordered collection of points; optionally has measure, height and ID attributes. |
| Point | A two dimensional point, optionally with measure, height, and ID attributes. |
| Polygon | A collection of rings ordered by their containment relationship; optionally has measure, height and ID attributes. |
| Polyline | An ordered collection of paths; optionally has measure, height and ID attributes. |
Remarks
These methods are intended to be called against top-level geometries only (Point, Multipoint, Polyline, Polygon, Envelope, MultiPatch). To call a method against a Segment/Path or Ring, first add the part to a Polyline or Polygon container, respectively, and then call the appropriate method against the container.These methods treat MultiPatch geometries as shell representations, where the interior is not considered part of the geometry. Consequently, a point situated inside a MultiPatch that does not touch one of its surfaces will be classified as disjoint from that MultiPatch.