com.esri.arcgis.geometry
Interface IConstructMerge

All Superinterfaces:

Serializable

All Known Implementing Classes:

GeometryEnvironment

public interface IConstructMerge
extends Serializable

Methods for doing a 3-way merge using two modified versions of a geometry along with the original.

Description

This interface is new at ArcGIS 9.3.

Method for constructing the merged geometry from two separate edits of the same original geometry. Currently implemented for Polylines and Polygons.

Product Availability

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

Method Summary

IGeometry

mergeGeometries(IGeometry pOriginal, IGeometry pEdit1, IGeometry pEdit2) Merges the representation from both versions of a geometry that has been modifed

Method Detail

mergeGeometries

IGeometry mergeGeometries(IGeometry pOriginal,
                          IGeometry pEdit1,
                          IGeometry pEdit2)
                          throws IOException,
                                 AutomationException

Merges the representation from both versions of a geometry that has been modifed

Description

Constructs a new geometry by merging the two separate edits of the same original geometry. If any portion of the two edited regions or the edits themselves overlaps an error will be returned. Edited regions are the areas of the polygon or polyline where the edits took place in respect to the original geometry. Edits are the changes reflected in the two edited geometries.
In polygons it is the area that the edit has been affected as well as the vertices and edges that participated in the edits that are important. Even if edits are on non-consecutive edges or non-consecutive vertices, if the area that one edit adds or subtracts from the polygon overlaps the second edit this will be viewed as a conflict and the geometries will not be merged.

The functionality is fully implemented for multipart features.

Remarks

IConstructMerge pConstMrg = new GeometryEnvironmentClass() as IConstructMerge;

\/*IGeometry origGeom;

IGeometry geom1;

IGeometry geom2;

...*\/

IGeometry newGeom = pConstMrg.MergeGeometries(origGeom, geom1, geom2);

Product Availability

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

Parameters:

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

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

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