com.esri.arcgis.geometry
Interface ICurve3

All Superinterfaces:

ICurve, ICurve2, IGeometry, Serializable

All Known Implementing Classes:

BezierCurve, CircularArc, EllipticArc, Line, Polyline

public interface ICurve3
extends ICurve2, Serializable

Provides access to members that extend the functionality of one dimensional curves.

Product Availability

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

Method Summary

void

queryPointsAndDistances(int extension, double searchRadius, IPoint inPoint, boolean asRatio, double[] distanceFromCurve, IEnumPointAndDistance[] pointsAndDistances) Given an input point, calculates the minimum distance to the geometry and provides an enumerator over all closest points on the geometry, along with additional information.

Methods inherited from interface com.esri.arcgis.geometry.ICurve2

putCoordsEx

Methods inherited from interface com.esri.arcgis.geometry.ICurve

getFromPoint, getLength, getSubcurve, getToPoint, isClosed, queryFromPoint, queryNormal, queryPoint, queryPointAndDistance, queryTangent, queryToPoint, reverseOrientation, setFromPoint, setToPoint

Methods inherited from interface com.esri.arcgis.geometry.IGeometry

geoNormalize, geoNormalizeFromLongitude, getDimension, getEnvelope, getGeometryType, getSpatialReference, isEmpty, project, queryEnvelope, setEmpty, setSpatialReferenceByRef, snapToSpatialReference

Method Detail

queryPointsAndDistances

void queryPointsAndDistances(int extension,
                             double searchRadius,
                             IPoint inPoint,
                             boolean asRatio,
                             double[] distanceFromCurve,
                             IEnumPointAndDistance[] pointsAndDistances)
                             throws IOException,
                                    AutomationException

Given an input point, calculates the minimum distance to the geometry and provides an enumerator over all closest points on the geometry, along with additional information.

Description

This method is similar to QueryPointsAndDistance; but it handles the case where the location of the minimum distance is not unique (See picture below). QueryPointAndDistance returns only the first location, this method returns all locations of minimum distance.

Remarks

AsRatio is an input parameter that only affects the DistanceAlongCurvereturned as part of the output IEnumPointAndDistance enumerator.

distanceFromCurve is an output parameter that represents the minimum distance between the curve and the input point.

IEnumPointAndDistance is an enumerator (it inherits from IEnumVertex) over all nearest points on the curve

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

extension - A com.esri.arcgis.geometry.esriSegmentExtension constant (in)

searchRadius - The searchRadius (in)

inPoint - A reference to a com.esri.arcgis.geometry.IPoint (in)

asRatio - The asRatio (in)

distanceFromCurve - The distanceFromCurve (in/out: use single element array)

pointsAndDistances - A reference to a com.esri.arcgis.geometry.IEnumPointAndDistance (out: use single element array)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.