Cut
Cut zerlegt ein Polygon oder eine Polylinie an einer Schnittlinie. Das Ergebnis ist eine flache Liste der Teile ohne links/rechts-Zuordnung, wie bei den Schnitt-Funktionen von Editierwerkzeugen (ADR 0007).
var square = Wkt.Read<IPolygon2D>("POLYGON((0 0, 10 0, 10 10, 0 10, 0 0))");
var cutter = Wkt.Read<IPolyline2D>("LINESTRING(5 -1, 5 11)");
IReadOnlyList<IPolygon2D> pieces = square.Cut(cutter);
Console.WriteLine(pieces.Count); // 2
Console.WriteLine(pieces[0].Area()); // 50
Die Signaturen sind Cut(this IPolygon2D, IPolyline2D cutter, IGeometryFactory? factory = null, double? gridSize = null) mit Rückgabe IReadOnlyList<IPolygon2D> und Cut(this IPolyline2D, IPolyline2D cutter, …) mit Rückgabe IReadOnlyList<IPolyline2D>.
Was als Teil zählt
- Jedes zerschnittene Stück ist ein eigenes Element.
- Alle unberührten Teilflächen (bzw. Pfade) bleiben zusammen ein Element und behalten ihre Originalkoordinaten, ohne Snap-Rounding. Ein Multipart-Feature zerfällt also nicht nebenbei, und was der Schnitt nicht trifft, bleibt unverändert.
- Wird nichts geschnitten, enthält die Liste genau ein Element.
- Die Reihenfolge der Elemente ist nicht festgelegt, das Ergebnis aber deterministisch.
Polygone
Die Teile sind die Maschen aus dem genodeten Polygonrand plus den Teilen der Schnittlinie im Inneren. Nur vollständige Durchquerungen schneiden: lose Enden der Schnittlinie, Verläufe entlang des Randes und Berührungen an Vertices schneiden nicht. Teile der Schnittlinie, die in einem Loch liegen, zählen nicht, und die Löcher werden passend auf die Teile verteilt.
Polylinien
Eine Polylinie wird an jedem Kontakt mit der Schnittlinie zerlegt: bei einer Kreuzung, einer Berührung in einem Punkt sowie am Anfang und Ende einer kollinearen Überlappung. Jedes Teil ist eine Polylinie mit genau einem Pfad.
Gut zu wissen
- Alle Pfade der Schnittlinie schneiden, mehrere Schnitte in einem Aufruf sind also möglich. Es gibt keine Optionen-Klasse.
- Die Schnittlinie wird nicht verlängert, jedenfalls nicht von
Cut. Um ihre Enden auf den Rand zu bringen, zuerst fangen (nächster Abschnitt). - Z und M an Schnittpunkten werden auf dem Originalsegment interpoliert.
Daten mit kleinen Fehlern: zuerst fangen
Cut ist exakt: Ein Ende der Schnittlinie, das 4 mm vor der Kante aufhört, ist ein loses Ende und schneidet nichts. Das passiert leicht bei gezeichneten oder projizierten Daten: Eine Karte, die das Ende auf der Kante fängt, wie sie in Web Mercator gerade ist, lässt es neben der Kante liegen, sobald die Stützpunkte nach UTM projiziert sind (Bruchteile eines Millimeters bei einer Kante von 100 m, Zentimeter bei einigen Kilometern). SnapTo bringt die Enden zuerst auf das Polygon (ADR 0046):
IReadOnlyList<IPolygon2D> pieces = parcel.Cut(fence.SnapTo(parcel, tolerance: 0.01));
Bei einer Polylinie verschiebt SnapTo standardmäßig nur die losen Enden (SnapMode.Ends): Ein Ende vor dem Ziel geht auf den nächsten Punkt (oder, mit SnapEnds.Extend, entlang seines letzten Segments), ein Ende, das weniger als die Toleranz darüber hinausläuft, wird abgeschnitten, und eine Ecke des Ziels in der Toleranz gewinnt, damit daneben kein Splitter bleibt. Die inneren Stützpunkte und der Rest der Linie bleiben. Die Toleranz ist Pflicht und in den Einheiten der Koordinaten angegeben; ein Punkt jenseits davon bleibt, wo er ist. Derselbe Schritt hilft vor den Overlays und den Prädikaten: SnapMode.Vertices verschiebt jeden Stützpunkt und fügt die Ecken des Ziels ein, sodass zwei benachbarte Flurstücke danach ihre Grenze teilen.