com.esri.arcgis.geometry
Interface ITopologicalOperator2

All Superinterfaces:

ITopologicalOperator, Serializable

All Known Subinterfaces:

ITopologicalOperator3, ITopologicalOperator4, ITopologicalOperator5

All Known Implementing Classes:

MultiPatch, Multipoint, Polygon, Polyline

public interface ITopologicalOperator2
extends ITopologicalOperator, Serializable

Provides access to members that extend the ITopologicalOperator interface.

Superseded By

ITopologicalOperator5

Remarks

ITopologicalOperator2 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.

For multipatch geometries, generally the footprint or envelope is used.

Product Availability

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

Method Summary

void	clipToDomain() Clips the geometry to the domain of the spatial reference.
IEnumGeometry	constructBuffers(int numBuffers, double[] distances) Deprecated. This method uses C style arrays which are not supported in the ArcGIS API for Java. It is replaced by GeometryEnvironment.constructBuffers(com.esri.arcgis.geometry.ITopologicalOperator2, double[]).
IGeometry	intersectMultidimension(IGeometry other) Constructs the set-theoretic intersection of the inputs.
void	setIsKnownSimple(boolean rhs1) Indicates whether this geometry is known (or assumed) to be topologically correct.

Methods inherited from interface com.esri.arcgis.geometry.ITopologicalOperator

buffer, clip, clipDense, constructUnion, convexHull, cut, difference, getBoundary, intersect, isKnownSimple, isSimple, queryClipped, queryClippedDense, simplify, symmetricDifference, union

Method Detail

constructBuffers

IEnumGeometry constructBuffers(int numBuffers,
                               double[] distances)
                               throws IOException,
                                      AutomationException

Deprecated. This method uses C style arrays which are not supported in the ArcGIS API for Java. It is replaced by GeometryEnvironment.constructBuffers(com.esri.arcgis.geometry.ITopologicalOperator2, double[]).

Constructs a set of buffers at various distances. More efficient than calling Buffer repeatedly on the same geometry. This method is intended for internal use only.

Remarks

use the generic version of this method accesible through the GeometryEnvironment singleton object via the IGeometryBridge interface.

This method is only implemented for polygons and polylines.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

numBuffers - The numBuffers (in)

distances - The distances (in)

Returns:

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

clipToDomain

void clipToDomain()
                  throws IOException,
                         AutomationException

Clips the geometry to the domain of the spatial reference. Useful for ensuring that buffers can be fit within the spatial domain of the feature class to which they are being added.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setIsKnownSimple

void setIsKnownSimple(boolean rhs1)
                      throws IOException,
                             AutomationException

Indicates whether this geometry is known (or assumed) to be topologically correct.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

rhs1 - The rhs1 (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

intersectMultidimension

IGeometry intersectMultidimension(IGeometry other)
                                  throws IOException,
                                         AutomationException

Constructs the set-theoretic intersection of the inputs. The results are returned in a geometry bag with one element per result dimension.

Remarks

This method only works with the following combination of geometries: Polygon with Polyline (and vice versa), Polyline with Multipoint (and vice versa), Polygon with Multipoint (and vice versa).

When using this method to intersect a Polygon with a Polyline (or vice versa) the geometry returned will be a GeometryBag.

When using this method to intersect a Multipoint with a Polygon (or vice versa) or Multipoint with a Polyline (or vice versa) the geometry returned will be a Multipoint.

If the desired combination of geometries is not available on this function, use Intersect on ITopologicalOperator.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

other - A reference to a com.esri.arcgis.geometry.IGeometry (in)

Returns:

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.