com.esri.arcgis.geometry
Interface IPolygon4

All Superinterfaces:
ICurve, IGeometry, IPolycurve, IPolygon, IPolygon2, IPolygon3, Serializable
All Known Implementing Classes:
Polygon

public interface IPolygon4
extends IPolygon3, Serializable

Provides access to members that extend the IPolygon3 interface.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux


Method Summary
 IGeometryBag getConnectedComponentBag()
          Creates and returns a geometry bag containing polygons that represent connected components of the original.
 IGeometryBag getExteriorRingBag()
          Creates and returns a geometry bag that contains references to all exterior rings.
 IGeometryBag getInteriorRingBag(IRing exteriorRing)
          Creates and returns a geometry bag that contains references to all rings that are interior to the specified exterior ring.
 IGeometryBag getOutermostComponentBag()
          Creates and returns a geometry bag containing polygons that represent outermost components of the original and all components within (islands within lakes).
 void simplifyEx(boolean preserveFromToPoints, boolean closeRings, boolean useXORRule)
          Same as ITopologicalOperator::Simplify, but with some additional options that affect performance and how the interior is classified.
 
Methods inherited from interface com.esri.arcgis.geometry.IPolygon3
simplifySpaghetti
 
Methods inherited from interface com.esri.arcgis.geometry.IPolygon2
getConnectedComponents, getOutermostComponents, queryExteriorRingsEx, queryInteriorRingsEx
 
Methods inherited from interface com.esri.arcgis.geometry.IPolygon
close, findExteriorRing, getExteriorRingCount, getInteriorRingCount, queryExteriorRings, queryInteriorRings, simplifyPreserveFromTo
 
Methods inherited from interface com.esri.arcgis.geometry.IPolycurve
densify, generalize, smooth, splitAtDistance, splitAtPoint, weed
 
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

simplifyEx

void simplifyEx(boolean preserveFromToPoints,
                boolean closeRings,
                boolean useXORRule)
                throws IOException,
                       AutomationException
Same as ITopologicalOperator::Simplify, but with some additional options that affect performance and how the interior is classified.

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:

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
preserveFromToPoints - The preserveFromToPoints (in)
closeRings - The closeRings (in)
useXORRule - The useXORRule (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getExteriorRingBag

IGeometryBag getExteriorRingBag()
                                throws IOException,
                                       AutomationException
Creates and returns a geometry bag that contains references to all exterior rings.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:
A reference to a com.esri.arcgis.geometry.IGeometryBag
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getInteriorRingBag

IGeometryBag getInteriorRingBag(IRing exteriorRing)
                                throws IOException,
                                       AutomationException
Creates and returns a geometry bag that contains references to all rings that are interior to the specified exterior ring.

Product Availability

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

Parameters:
exteriorRing - A reference to a com.esri.arcgis.geometry.IRing (in)
Returns:
A reference to a com.esri.arcgis.geometry.IGeometryBag
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getConnectedComponentBag

IGeometryBag getConnectedComponentBag()
                                      throws IOException,
                                             AutomationException
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.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:
A reference to a com.esri.arcgis.geometry.IGeometryBag
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getOutermostComponentBag

IGeometryBag getOutermostComponentBag()
                                      throws IOException,
                                             AutomationException
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.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:
A reference to a com.esri.arcgis.geometry.IGeometryBag
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.