Interface IPolygon4

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

Provides access to members that extend the IPolygon3 interface.

[InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
[Guid("5AF81EB6-5616-49A0-B0A6-E265803E4BD2")]
public interface IPolygon4 : IPolygon3, IPolygon2, IPolygon, IPolycurve, ICurve, IGeometry

Properties

ConnectedComponentBag

Creates and returns a geometry bag containing polygons that represent connected components of the original. The rings of the output polygons are references to rings in the original.

IGeometryBag ConnectedComponentBag { get; }

Property Value

IGeometryBag

Dimension

esriGeometryDimension Dimension { get; }

Property Value

esriGeometryDimension

Envelope

IEnvelope Envelope { get; }

Property Value

IEnvelope

ExteriorRingBag

Creates and returns a geometry bag that contains references to all exterior rings.

IGeometryBag ExteriorRingBag { get; }

Property Value

IGeometryBag

ExteriorRingCount

int ExteriorRingCount { get; }

Property Value

int

FromPoint

IPoint FromPoint { get; set; }

Property Value

IPoint

GeometryType

esriGeometryType GeometryType { get; }

Property Value

esriGeometryType

InteriorRingBag[IRing]

Creates and returns a geometry bag that contains references to all rings that are interior to the specified exterior ring.

IGeometryBag InteriorRingBag[IRing exteriorRing] { get; }

Parameters

exteriorRing IRing

Property Value

IGeometryBag

InteriorRingCount[IRing]

int InteriorRingCount[IRing exteriorRing] { get; }

Parameters

exteriorRing IRing

Property Value

int

IsClosed

bool IsClosed { get; }

Property Value

bool

IsEmpty

bool IsEmpty { get; }

Property Value

bool

Length

double Length { get; }

Property Value

double

OutermostComponentBag

Creates and returns a geometry bag containing polygons that represent outermost components of the original and all components within (islands within lakes). The rings of the output polygons are references to rings in the original.

IGeometryBag OutermostComponentBag { get; }

Property Value

IGeometryBag

SpatialReference

ISpatialReference SpatialReference { get; set; }

Property Value

ISpatialReference

ToPoint

IPoint ToPoint { get; set; }

Property Value

IPoint

Methods

Close()

void Close()

Densify(double, double)

void Densify(double maxSegmentLength, double maxDeviation)

Parameters

maxSegmentLength double
maxDeviation double

FindExteriorRing(IRing)

IRing FindExteriorRing(IRing interiorRing)

Parameters

interiorRing IRing

Returns

IRing

Generalize(double)

void Generalize(double maxAllowableOffset)

Parameters

maxAllowableOffset double

GeoNormalize()

void GeoNormalize()

GeoNormalizeFromLongitude(double)

void GeoNormalizeFromLongitude(double Longitude)

Parameters

Longitude double

GetConnectedComponents(int, out IPolygon)

void GetConnectedComponents(int numComponentsRequested, out IPolygon components)

Parameters

numComponentsRequested int
components IPolygon

GetConnectedComponents2(out IPolygon[])

void GetConnectedComponents2(out IPolygon[] components)

Parameters

components IPolygon[]

GetOutermostComponents(int, out int, out IPolygon, out bool)

void GetOutermostComponents(int numComponentsRequested, out int numComponentsReturned, out IPolygon components, out bool moreComponentsExist)

Parameters

numComponentsRequested int
numComponentsReturned int
components IPolygon
moreComponentsExist bool

GetOutermostComponents2(out IPolygon[], out bool)

void GetOutermostComponents2(out IPolygon[] components, out bool moreComponentsExist)

Parameters

components IPolygon[]
moreComponentsExist bool

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

QueryExteriorRings(ref IRing)

void QueryExteriorRings(ref IRing exteriorRings)

Parameters

exteriorRings IRing

QueryExteriorRingsEx(int, out IRing)

void QueryExteriorRingsEx(int numExteriorRingsRequested, out IRing exteriorRings)

Parameters

numExteriorRingsRequested int
exteriorRings IRing

QueryExteriorRingsEx2(out IRing[])

void QueryExteriorRingsEx2(out IRing[] exteriorRings)

Parameters

exteriorRings IRing[]

QueryFromPoint(IPoint)

void QueryFromPoint(IPoint from)

Parameters

from IPoint

QueryInteriorRings(IRing, ref IRing)

void QueryInteriorRings(IRing exteriorRing, ref IRing interiorRings)

Parameters

exteriorRing IRing
interiorRings IRing

QueryInteriorRingsEx(IRing, int, out IRing)

void QueryInteriorRingsEx(IRing exteriorRing, int numInteriorRingsRequested, out IRing interiorRings)

Parameters

exteriorRing IRing
numInteriorRingsRequested int
interiorRings IRing

QueryInteriorRingsEx2(int, out IRing[])

void QueryInteriorRingsEx2(int exteriorRingIndex, out IRing[] interiorRings)

Parameters

exteriorRingIndex int
interiorRings IRing[]

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()

SimplifyEx(bool, bool, bool)

Same as ITopologicalOperator::Simplify, but with some additional options that affect performance and how the interior is classified.

void SimplifyEx(bool preserveFromToPoints, bool closeRings, bool useXORRule)

Parameters

preserveFromToPoints bool
closeRings bool
useXORRule bool

Remarks

Parameters:

preserveFromToPoints: Boolean value that determines if the from/to points of a ring in the polygon need to remain located at ring indexes 0 and PointCount-1 af the completion of the operation. Specify 'false' to improve performance of this operation.

closeRings : Boolean value that determines if the rings of the polygon must be closed prior to reconstruct the topology of the polygon. Specify false if you know that rings are closed or you are passing in spaghetti input that should not be checked for closure.

useXORRule: Boolean value that determines how the 'inside' of the polygon is determined. Specify true to use an even-odd counting rule: a point is inside the polygon if a horizontal line through that has encountered an odd number of boundaries to the left (overlapping boundaries count 1 for each overlap). Use this when the input consists of well-defined rings that need to be oriented correctly, have overlaps removed, etc. Specify false to use the default behavior, which iterates over a two step process: dangle removal, then "peeling off" of the largest unambiguous rings. This approach can remove more segments than the XOR-true approach, but is probably more appropriate for spaghetti input where segment overlaps should not be considered significant.

 

Here is an example of the different between XOR=TRUE vs. XOR= FALSE:

SimplifyPreserveFromTo()

void SimplifyPreserveFromTo()

SimplifySpaghetti()

void SimplifySpaghetti()

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

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

Weed(double)

void Weed(double maxAllowableOffsetFactor)

Parameters

maxAllowableOffsetFactor double