com.esri.arcgis.geometry
Class IPolygon4Proxy

java.lang.Object
  com.esri.arcgis.interop.Dispatch
      com.esri.arcgis.geometry.IGeometryProxy
          com.esri.arcgis.geometry.ICurveProxy
              com.esri.arcgis.geometry.IPolycurveProxy
                  com.esri.arcgis.geometry.IPolygonProxy
                      com.esri.arcgis.geometry.IPolygon2Proxy
                          com.esri.arcgis.geometry.IPolygon3Proxy
                              com.esri.arcgis.geometry.IPolygon4Proxy

All Implemented Interfaces:

java.io.Externalizable, ICurve, IGeometry, IPolycurve, IPolygon, IPolygon2, IPolygon3, IPolygon4, java.io.Serializable

public class IPolygon4Proxy

extends IPolygon3Proxy

implements IPolygon4, java.io.Serializable

Provides access to members that extend the IPolygon3 interface.

Product Availability

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

See Also:

Serialized Form

Field Summary

static java.lang.Class

targetClass

Fields inherited from class com.esri.arcgis.interop.Dispatch

DISPATCH_METHOD, DISPATCH_PROPERTYGET, DISPATCH_PROPERTYPUT, DISPATCH_PROPERTYPUTREF

Constructor Summary

	IPolygon4Proxy() For internal use only
	IPolygon4Proxy(java.lang.Object obj)
protected	IPolygon4Proxy(java.lang.Object obj, java.lang.String iid)
	IPolygon4Proxy(java.lang.String CLSID, java.lang.String host, AuthInfo authInfo)
protected	IPolygon4Proxy(java.lang.String CLSID, java.lang.String iid, java.lang.String host, AuthInfo authInfo)

Method Summary

void	addListener(java.lang.String iidStr, java.lang.Object theListener, java.lang.Object theSource) Adds a Java object to be a listener for a specific kind of event generated by the COM object.
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	removeListener(java.lang.String iidStr, java.lang.Object theListener) Removes a Java object as a listener to events generated by a COM object.
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 class com.esri.arcgis.geometry.IPolygon3Proxy

simplifySpaghetti

Methods inherited from class com.esri.arcgis.geometry.IPolygon2Proxy

getConnectedComponents, getOutermostComponents, queryExteriorRingsEx, queryInteriorRingsEx

Methods inherited from class com.esri.arcgis.geometry.IPolygonProxy

close, findExteriorRing, getExteriorRingCount, getInteriorRingCount, queryExteriorRings, queryInteriorRings, simplifyPreserveFromTo

Methods inherited from class com.esri.arcgis.geometry.IPolycurveProxy

densify, generalize, smooth, splitAtDistance, splitAtPoint, weed

Methods inherited from class com.esri.arcgis.geometry.ICurveProxy

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

Methods inherited from class com.esri.arcgis.geometry.IGeometryProxy

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

Methods inherited from class com.esri.arcgis.interop.Dispatch

bindUsingMoniker, convertToNative, cookieForListener, createDispatch, createObjrefMonikerDisplayName, equals, getActiveObject, getActiveObject, getDefaultProperty, getDispatchIdOfName, getLastErrorCode, getMtsObjectContext, getObjRef, getPropertyByName, getPropertyByName, hashCode, invoke, invokeMethodByName, invokeMethodByName, invokeMethodByName, invokePropertyGetByName, invokePropertyPutByName, invokePropertyPutByRefByName, isNativeMode, isObjRef, queryInterface, readExternal, setNativeMode, setPropertyByName, toString, vtblInvoke, writeExternal

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

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

Field Detail

targetClass

public static final java.lang.Class targetClass

Constructor Detail

IPolygon4Proxy

public IPolygon4Proxy(java.lang.String CLSID,
                      java.lang.String host,
                      AuthInfo authInfo)
               throws java.net.UnknownHostException,
                      java.io.IOException

IPolygon4Proxy

public IPolygon4Proxy()

For internal use only

IPolygon4Proxy

public IPolygon4Proxy(java.lang.Object obj)
               throws java.io.IOException

IPolygon4Proxy

protected IPolygon4Proxy(java.lang.Object obj,
                         java.lang.String iid)
                  throws java.io.IOException

IPolygon4Proxy

protected IPolygon4Proxy(java.lang.String CLSID,
                         java.lang.String iid,
                         java.lang.String host,
                         AuthInfo authInfo)
                  throws java.io.IOException

Method Detail

addListener

public void addListener(java.lang.String iidStr,
                        java.lang.Object theListener,
                        java.lang.Object theSource)
                 throws java.io.IOException

Description copied from class: Dispatch

Adds a Java object to be a listener for a specific kind of event generated by the COM object. when you wish to invoke method on the COM object using IDispatch (not using custom marshalling).

Overrides:

addListener in class IPolygon3Proxy

Throws:

java.io.IOException

removeListener

public void removeListener(java.lang.String iidStr,
                           java.lang.Object theListener)
                    throws java.io.IOException

Description copied from class: Dispatch

Removes a Java object as a listener to events generated by a COM object. when you wish to invoke method on the COM object using IDispatch (not using custom marshalling).

Overrides:

removeListener in class IPolygon3Proxy

Throws:

java.io.IOException

simplifyEx

public void simplifyEx(boolean preserveFromToPoints,
                       boolean closeRings,
                       boolean useXORRule)
                throws java.io.IOException,
                       AutomationException

Description copied from interface: IPolygon4

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

Supported Platforms

Windows, Solaris, Linux

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:

Specified by:

simplifyEx in interface IPolygon4

Parameters:

preserveFromToPoints - The preserveFromToPoints (in)

closeRings - The closeRings (in)

useXORRule - The useXORRule (in)

Throws:

AutomationException - If the ArcObject component throws an exception.

java.io.IOException - If there are interop problems.

getExteriorRingBag

public IGeometryBag getExteriorRingBag()
                                throws java.io.IOException,
                                       AutomationException

Description copied from interface: IPolygon4

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

Supported Platforms

Windows, Solaris, Linux

Specified by:

getExteriorRingBag in interface IPolygon4

Returns:

A reference to a com.esri.arcgis.geometry.IGeometryBag

Throws:

AutomationException - If the ArcObject component throws an exception.

java.io.IOException - If there are interop problems.

getInteriorRingBag

public IGeometryBag getInteriorRingBag(IRing exteriorRing)
                                throws java.io.IOException,
                                       AutomationException

Description copied from interface: IPolygon4

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

Supported Platforms

Windows, Solaris, Linux

Specified by:

getInteriorRingBag in interface IPolygon4

Parameters:

exteriorRing - A reference to a com.esri.arcgis.geometry.IRing (in)

Returns:

A reference to a com.esri.arcgis.geometry.IGeometryBag

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getConnectedComponentBag

public IGeometryBag getConnectedComponentBag()
                                      throws java.io.IOException,
                                             AutomationException

Description copied from interface: IPolygon4

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.

Supported Platforms

Windows, Solaris, Linux

Specified by:

getConnectedComponentBag in interface IPolygon4

Returns:

A reference to a com.esri.arcgis.geometry.IGeometryBag

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getOutermostComponentBag

public IGeometryBag getOutermostComponentBag()
                                      throws java.io.IOException,
                                             AutomationException

Description copied from interface: IPolygon4

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.

Supported Platforms

Windows, Solaris, Linux

Specified by:

getOutermostComponentBag in interface IPolygon4

Returns:

A reference to a com.esri.arcgis.geometry.IGeometryBag

Throws:

AutomationException - If the ArcObject component throws an exception.

java.io.IOException - If there are interop problems.