Generalize Method (IGeometryEngine)

In This Topic

Performs the generalize operation on the geometry.

Syntax

C#
Visual Basic (Declaration)

Geometry Generalize( 
   Geometry geometry,
   double maxDeviation,
   bool removeDegenerateParts,
   bool preserveCurves
)

Function Generalize( _
   ByVal geometry As Geometry, _
   ByVal maxDeviation As Double, _
   Optional ByVal removeDegenerateParts As Boolean, _
   Optional ByVal preserveCurves As Boolean _
) 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.
removeDegenerateParts: When true, the degenerate parts of the geometry will be removed from the output.
preserveCurves: (Optional) The default value is false.

Return Value

The generalized geometry.

Exceptions

Exception	Description
System.ArgumentNullException	Geometry is null or empty.
System.NotImplementedException	The method is not implemented for GeometryBag or Multipatch.
ArcGIS.Core.Geometry.Exceptions.GeometryObjectException	The geomtry is of an incorrect type. (i.e. a point or multipoint).

Remarks

Generalize performs a Douglas-Peucker Generalization algorithm with a specified maximum offset tolerance given as input. For line segments, the generalized output is a subset of the original input vertices. For non-linear segments, if is false, then the generalized output contains points along all parts of the curve, not necessarily only the vertices. If is true, then the non-linear segments are left as is.

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, Windows 8.1

Reference

IGeometryEngine Interface
IGeometryEngine Members

Send feedback