Generalize3D Method (IGeometryEngine)

In This Topic

Performs the generalize operation on the geometry.

Syntax

C#
Visual Basic (Declaration)

Geometry Generalize3D( 
   Geometry geometry,
   double maxDeviation
)

Function Generalize3D( _
   ByVal geometry As Geometry, _
   ByVal maxDeviation As Double _
) As Geometry

Parameters

geometry: The geometry to be generalized.
maxDeviation: The maximum distance in meters that the output geometry can deviate from the input geometry.

Return Value

The generalized geometry. If the input geometry is empty, then it is returned unchanged.

Exceptions

Exception	Description
System.ArgumentNullException	Geometry is null.
System.NotImplementedException	The method is not implemented for GeometryBag or Multipatch.
System.InvalidOperationException	This geometry is not Z-Aware.
ArcGIS.Core.Geometry.Exceptions.GeometryObjectException	The geometry is of an incorrect type. (i.e. a point or multipoint).
ArcGIS.Core.Geometry.Exceptions.OperationException	Cannot do 3D operations on curve segments.

Remarks

Generalize3D performs a Douglas-Peucker Generalization algorithm, extended to operate in 3D space, with a specified maximum offset tolerance, given in 3D, as input. For line segments, the generalized output is a subset of the original input vertices. For non-linear segments, the generalized output contains points along all parts of the curve, not necessarily only the vertices.

GeometryEngine Generalize3D

Example

Generalize

Polyline generalizedPolyline = GeometryEngine.Instance.Generalize(polylineWithZ, 200) as Polyline;
// generalizedPolyline.HasZ = true

Polygon generalized3DPolyline = GeometryEngine.Instance.Generalize3D(polylineWithZ, 200) as Polygon;
// generalized3DPolyline.HasZ = true

// note that generalized3DPolyline and generalizedPolyline will have different definitions
//  ie generalizedPolyline.IsEqual(generalized3DPolyline) = false

Requirements

Target Platforms: Windows 11, Windows 10

ArcGIS Pro version: 3 or higher.

Reference

IGeometryEngine Interface
IGeometryEngine Members

Send feedback