Clip Method (IGeometryEngine)

In This Topic

Constructs the polygon created by clipping geometry by envelope.

Syntax

C#
Visual Basic (Declaration)

Geometry Clip( 
   Geometry geometry,
   Envelope envelope
)

Function Clip( _
   ByVal geometry As Geometry, _
   ByVal envelope As Envelope _
) As Geometry

Parameters

geometry: The geometry to be clipped by the given envelope.
envelope: A geometry that represents the area clipped by envelope.

Return Value

The clipped geometry.

Exceptions

Exception	Description
System.ArgumentNullException	Either geometry or envelope or both are null or empty.
System.NotImplementedException	The method is not implemented for GeometryBag.
System.InvalidOperationException	Incompatible spatial references between the input geometries.

Remarks

If the input geometry is a multipatch, then the multipatch is projected to the 2D-plane. The output geometry will be a polygon.

GeometryEngine Clip

Example

Clip a Polyline

// clip a polyline by an envelope

Envelope env = EnvelopeBuilderEx.CreateEnvelope(2.0, 2.0, 4.0, 4.0);
LineSegment line = LineBuilderEx.CreateLineSegment(new Coordinate2D(0, 3), new Coordinate2D(5.0, 3.0));
Polyline polyline = PolylineBuilderEx.CreatePolyline(line);

Geometry clipGeom = GeometryEngine.Instance.Clip(polyline, env);

Clip a Polyline by a Polygon

// clip a polyline by a polygon

List<Coordinate2D> list = new List<Coordinate2D>();
list.Add(new Coordinate2D(1.0, 1.0));
list.Add(new Coordinate2D(1.0, 4.0));
list.Add(new Coordinate2D(4.0, 4.0));
list.Add(new Coordinate2D(4.0, 1.0));

Polygon polygon = PolygonBuilderEx.CreatePolygon(list, SpatialReferences.WGS84);

LineSegment crossingLine = LineBuilderEx.CreateLineSegment(MapPointBuilderEx.CreateMapPoint(0, 3), MapPointBuilderEx.CreateMapPoint(5.0, 3.0));
Polyline p = PolylineBuilderEx.CreatePolyline(crossingLine);
Geometry geometry = GeometryEngine.Instance.Clip(p, polygon.Extent);

Requirements

Target Platforms: Windows 11, Windows 10

ArcGIS Pro version: 3 or higher.

Reference

IGeometryEngine Interface
IGeometryEngine Members

Send feedback