Interface ITopologicalOperator3

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

Provides additional information on non-simple geometries.

[Guid("D4DC3B12-88EA-42D8-87B7-4EB7460737C1")]
[InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
public interface ITopologicalOperator3 : ITopologicalOperator2, ITopologicalOperator

Remarks

ITopologicalOperator3 methods must be applied on high-level geometries only. High-Level geometries are point, multipoint, polyline and polygon. To use this interface with low-level geometries such as segments (Line, Circular Arc, Elliptic Arc, Bezier Curve), paths or rings, they must be wrapped into high-level geometry types.

Properties

Boundary

IGeometry Boundary { get; }

Property Value

IGeometry

IsKnownSimple

bool IsKnownSimple { get; }

Property Value

bool

IsKnownSimple_2

bool IsKnownSimple_2 { set; }

Property Value

bool

IsSimple

bool IsSimple { get; }

Property Value

bool

IsSimpleEx[esriNonSimpleReasonEnum]

Determines why a geometry is not simple. Currently only implemented for polygons.

bool IsSimpleEx[out esriNonSimpleReasonEnum reason] { get; }

Parameters

reason esriNonSimpleReasonEnum

Property Value

bool

Remarks

Note: All geometries involved in ITopologicalOperator operations must be high-level geometries. High-Level geometries are point, multipoint, polyline and polygon. To use it with low-level geometries such as segments (Line, Circular Arc, Elliptic Arc, Bézier Curve), path or ring they must be wrapped into high-level geometries type.

 

The xy cluster tolerance value of the geometry's associated spatial reference is used by this method. If the goal of this method is to determine if a geometry can be persisted in an sde (or other integer-based) layer without alteration, you may wish to use the minimum xy cluster tolerance value (ISpatialReferenceTolerance::SetMinimumXYTolerance) before applying this method (don't forget to set it back).

[C#]

//How to use get_IsSimpleEx

ITopologicalOperator3 topoOp3 = inGeom as ITopologicalOperator3; //Must be polygon

ESRI.ArcGIS.Geometry.esriNonSimpleReasonEnum reason = ESRI.ArcGIS.Geometry.esriNonSimpleReasonEnum.esriNonSimpleOK; //Initialize

topoOp3.IsKnownSimple_2 = false;

Boolean pBool = topoOp3.get_IsSimpleEx(out reason); //Inspect pReason for description code

 

//The following code shows to wrap a line segment into a polyline in C#

//Assume a line (line1 as ILine) is already created

object obj = Type.Missing;

ISegmentCollection segCollection = new PolylineClass() as ISegmentCollection;

segCollection.AddSegment((ISegment)line1, ref obj, ref obj);

//Set the spatial reference on the new polyline

//The spatial reference is not transfered automatically from the segments

IGeometry geom = segCollection as IGeometry;

geom.SpatialReference = spatialRef;

//Can now be used with ITopologicalOperator methods

Methods

Buffer(double)

IGeometry Buffer(double distance)

Parameters

distance double

Returns

IGeometry

Clip(IEnvelope)

void Clip(IEnvelope clipperEnvelope)

Parameters

clipperEnvelope IEnvelope

ClipDense(IEnvelope, double)

void ClipDense(IEnvelope clipperEnvelope, double denseDistance)

Parameters

clipperEnvelope IEnvelope
denseDistance double

ClipToDomain()

void ClipToDomain()

ConstructBuffers(int, ref double)

IEnumGeometry ConstructBuffers(int numBuffers, ref double distances)

Parameters

numBuffers int
distances double

Returns

IEnumGeometry

ConstructUnion(IEnumGeometry)

void ConstructUnion(IEnumGeometry geometries)

Parameters

geometries IEnumGeometry

ConvexHull()

IGeometry ConvexHull()

Returns

IGeometry

Cut(IPolyline, out IGeometry, out IGeometry)

void Cut(IPolyline cutter, out IGeometry leftGeom, out IGeometry rightGeom)

Parameters

cutter IPolyline
leftGeom IGeometry
rightGeom IGeometry

Difference(IGeometry)

IGeometry Difference(IGeometry other)

Parameters

other IGeometry

Returns

IGeometry

GeoNormalizeEx(ISpatialReference, double)

Shifts longitudes, if need be, into a continuous range of 360 degrees.

void GeoNormalizeEx(ISpatialReference SR, double denseDistance)

Parameters

SR ISpatialReference
denseDistance double

Remarks

Not implemented for Multipatches.

Intersect(IGeometry, esriGeometryDimension)

IGeometry Intersect(IGeometry other, esriGeometryDimension resultDimension)

Parameters

other IGeometry
resultDimension esriGeometryDimension

Returns

IGeometry

IntersectMultidimension(IGeometry)

IGeometry IntersectMultidimension(IGeometry other)

Parameters

other IGeometry

Returns

IGeometry

QueryClipped(IEnvelope, IGeometry)

void QueryClipped(IEnvelope clipperEnvelope, IGeometry clippedGeometry)

Parameters

clipperEnvelope IEnvelope
clippedGeometry IGeometry

QueryClippedDense(IEnvelope, double, IGeometry)

void QueryClippedDense(IEnvelope clipperEnvelope, double denseDistance, IGeometry clippedGeometry)

Parameters

clipperEnvelope IEnvelope
denseDistance double
clippedGeometry IGeometry

Simplify()

void Simplify()

SymmetricDifference(IGeometry)

IGeometry SymmetricDifference(IGeometry other)

Parameters

other IGeometry

Returns

IGeometry

TopologyCache(out long)

void TopologyCache(out long topologyCacheHandle)

Parameters

topologyCacheHandle long

Union(IGeometry)

IGeometry Union(IGeometry other)

Parameters

other IGeometry

Returns

IGeometry