Interface IPolycurve2

Namespace
ESRI.ArcGIS.Geometry
Assembly
ESRI.Server.Geometry.dll

Provides access to members that extend IPolycurve with additional splitting and densification methods.

[Guid("F4737332-F6B7-11D3-9F6A-00C04F6BDD7F")]
[InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
public interface IPolycurve2 : IPolycurve, ICurve, IGeometry

Properties

Dimension

esriGeometryDimension Dimension { get; }

Property Value

esriGeometryDimension

Envelope

IEnvelope Envelope { get; }

Property Value

IEnvelope

FromPoint

IPoint FromPoint { get; set; }

Property Value

IPoint

GeometryType

esriGeometryType GeometryType { get; }

Property Value

esriGeometryType

IsClosed

bool IsClosed { get; }

Property Value

bool

IsEmpty

bool IsEmpty { get; }

Property Value

bool

Length

double Length { get; }

Property Value

double

SpatialReference

ISpatialReference SpatialReference { get; set; }

Property Value

ISpatialReference

ToPoint

IPoint ToPoint { get; set; }

Property Value

IPoint

Methods

Densify(double, double)

void Densify(double maxSegmentLength, double maxDeviation)

Parameters

maxSegmentLength double
maxDeviation double

DensifyByAngle(double, double)

Converts this polycurve into a piecewise linear approximation of itself. Vertices are introduced at points where the included angle between tangents at those point is maxAngleDeviation.

void DensifyByAngle(double maxSegmentLength, double maxAngleDeviation)

Parameters

maxSegmentLength double
maxAngleDeviation double

Remarks

If the maxSegmentLength is negative IGeometryEnvironment::AutoDensifyTolerance is used. IGeometryEnvironment::AutoDensifyTolerance default value is 0. This value can be explicitly set via IGeometryEnvironment::AutoDensifyTolerance.

If the maxDeviation is negative IGeometryEnvironment::AngularAutoDensifyTolerance is used. The default value is Pi / 18.0. That value can be explicitly set via IGeometryEnvironment::AngularAutoDensifyTolerance.

In order to avoid the creation of too many segments,  the geometry system uses a maxDeviation = 2*XYresolution * 100 (or 2/XYUnits * 100) as the default value if maxSegmentLength is 0 and the maxDeviation is 0.

The maximum number of segments that can be produced is 2000, an external user cannot modify that value.


NOTE: The default values given in this topic are subject to change without notice. If you have specific values that you want to be maintained, we recommend using the methods on IGeometryEnvironment to set them explicitly.

The start and end points are always honored and remain the same as for the original feature.

 

Generalize(double)

void Generalize(double maxAllowableOffset)

Parameters

maxAllowableOffset double

GeoNormalize()

void GeoNormalize()

GeoNormalizeFromLongitude(double)

void GeoNormalizeFromLongitude(double Longitude)

Parameters

Longitude double

GetSubcurve(double, double, bool, out ICurve)

void GetSubcurve(double fromDistance, double toDistance, bool asRatio, out ICurve outSubcurve)

Parameters

fromDistance double
toDistance double
asRatio bool
outSubcurve ICurve

Project(ISpatialReference)

void Project(ISpatialReference newReferenceSystem)

Parameters

newReferenceSystem ISpatialReference

QueryEnvelope(IEnvelope)

void QueryEnvelope(IEnvelope outEnvelope)

Parameters

outEnvelope IEnvelope

QueryFromPoint(IPoint)

void QueryFromPoint(IPoint from)

Parameters

from IPoint

QueryNormal(esriSegmentExtension, double, bool, double, ILine)

void QueryNormal(esriSegmentExtension extension, double DistanceAlongCurve, bool asRatio, double Length, ILine normal)

Parameters

extension esriSegmentExtension
DistanceAlongCurve double
asRatio bool
Length double
normal ILine

QueryPoint(esriSegmentExtension, double, bool, IPoint)

void QueryPoint(esriSegmentExtension extension, double DistanceAlongCurve, bool asRatio, IPoint outPoint)

Parameters

extension esriSegmentExtension
DistanceAlongCurve double
asRatio bool
outPoint IPoint

QueryPointAndDistance(esriSegmentExtension, IPoint, bool, IPoint, ref double, ref double, ref bool)

void QueryPointAndDistance(esriSegmentExtension extension, IPoint inPoint, bool asRatio, IPoint outPoint, ref double DistanceAlongCurve, ref double distanceFromCurve, ref bool bRightSide)

Parameters

extension esriSegmentExtension
inPoint IPoint
asRatio bool
outPoint IPoint
DistanceAlongCurve double
distanceFromCurve double
bRightSide bool

QueryTangent(esriSegmentExtension, double, bool, double, ILine)

void QueryTangent(esriSegmentExtension extension, double DistanceAlongCurve, bool asRatio, double Length, ILine tangent)

Parameters

extension esriSegmentExtension
DistanceAlongCurve double
asRatio bool
Length double
tangent ILine

QueryToPoint(IPoint)

void QueryToPoint(IPoint to)

Parameters

to IPoint

ReverseOrientation()

void ReverseOrientation()

SetEmpty()

void SetEmpty()

Smooth(double)

void Smooth(double maxAllowableOffset)

Parameters

maxAllowableOffset double

SnapToSpatialReference()

void SnapToSpatialReference()

SplitAtDistance(double, bool, bool, out bool, out int, out int)

void SplitAtDistance(double distance, bool asRatio, bool createPart, out bool SplitHappened, out int newPartIndex, out int newSegmentIndex)

Parameters

distance double
asRatio bool
createPart bool
SplitHappened bool
newPartIndex int
newSegmentIndex int

SplitAtDistances(int, ref double, bool, bool)

Introduces new vertices into this polyline at specified distances from the beginning of the polyline.

IEnumSplitPoint SplitAtDistances(int distanceCount, ref double distances, bool asRatios, bool createParts)

Parameters

distanceCount int
distances double
asRatios bool
createParts bool

Returns

IEnumSplitPoint

SplitAtPoint(IPoint, bool, bool, out bool, out int, out int)

void SplitAtPoint(IPoint splitPoint, bool projectOnto, bool createPart, out bool SplitHappened, out int newPartIndex, out int newSegmentIndex)

Parameters

splitPoint IPoint
projectOnto bool
createPart bool
SplitHappened bool
newPartIndex int
newSegmentIndex int

SplitAtPoints(IEnumVertex, bool, bool, double)

Introduces new vertices into this polyline at the locations on it closest to the input points. Do not consider points farther than cutoffDistance from the polyline.

IEnumSplitPoint SplitAtPoints(IEnumVertex splitPoints, bool projectOnto, bool createParts, double cutoffDistance)

Parameters

splitPoints IEnumVertex
projectOnto bool
createParts bool
cutoffDistance double

Returns

IEnumSplitPoint

Remarks

Parameters description:

splitPoints: Input IEnumVertex object. It represents the points to be used to split the polycurve.

projectOnto: The projectOnto is an input parameter that determines if the output point will be located on the polycurve. If projectOnto is true and the input point is not already on the polycurve then the point is projected on the curve. If false, the polycurve is split and modified to pass trough the point.

createParts: The createParts is an input parameter that determines if parts (paths) have to be created. createPart must be FALSE for polygons.  For polylines, if createPart is TRUE, the part on which the new split point falls is split into two parts with the newly added vertex serving as the end of the first part and the beginning of the second.

cutoffDistance: Input Double that represents the distance from the curve from where points are not considered anymore has being valid split points.

Note: The IEnumSplitPoint contains the input points.

Weed(double)

void Weed(double maxAllowableOffsetFactor)

Parameters

maxAllowableOffsetFactor double