API-Signaturen: typisierte Overloads, Werte statt Geometrien für punktförmige Maße, feste Exception-Regeln
Algorithmen haben typisierte Overloads, deren Rückgabetyp sich aus der Strict-Semantik (ADR 0005) ergibt, plus je eine allgemeine IGeometry2D-Overload, die zur Laufzeit verzweigt. Der Compiler kennt so den Ergebnistyp ohne Cast. Punktförmige Maße sind Werte statt Geometrien: Centroid() liefert Coordinate? (null bei leerer Eingabe) und braucht keine Factory. Distance mit einer leeren Geometrie ist NaN. Das ist eine bewusste Abweichung von NTS, das 0 liefert und damit „berührt sich“ und „nichts da“ verwechselbar macht.
English version: 0012-api-signaturen-typisierte-overloads.md
Consequences
- Binäre Operationen:
- Intersection: Polygon ∩ Polygon →
IPolygon2D. Polygon ∩ Polylinie und Polylinie ∩ Polylinie →IPolyline2D, nur Überlappungen, reine Kreuzungspunkte fallen nach Strict weg. Multipunkt bzw. Punkt ∩ beliebig →IMultiPoint2D. - Union und SymDifference: nur für gleiche Dimension.
- Difference: liefert den Typ des ersten Operanden.
- Intersection: Polygon ∩ Polygon →
- Maße:
AreaaufIPolygon2D,LengthaufIPolyline2DundIPolygon2D(Umfang).- Allgemeine Overloads auf
IGeometry2Dliefern 0, wenn das Maß nicht zur Dimension passt. Envelope()liefertEnvelope2D, bei leerer EingabeEnvelope2D.Empty(NaN,IsEmpty).
- ConvexHull liefert
IGeometry2D. Je nach Entartung ist das ein Polygon, eine Polylinie oder ein Multipunkt, wie JTS. - Simplify liefert den Eingabetyp.
- Standard: Douglas-Peucker und danach Normalisierung über das Overlay (Union mit EvenOdd). Das Ergebnis ist immer gültig (ADR 0003), kollabierte Ringe fallen weg.
preserveTopology: true: ein topologieerhaltender Simplifier nach dem Muster von JTSTopologyPreservingSimplifier. Das ist ein zusätzlicher Algorithmus im v1-Umfang.
- IsValid:
IsValid()liefertbool,Validate()liefertValidationResultmit Befunden aus Art undCoordinate. Die Arten sindSelfIntersection,RingSelfTouch,DegenerateRing,InvalidCoordinate,TooFewPointsundOverlappingShells, nach ADR 0003 und nicht 1:1 aus NTS (ein fehlender Schlusspunkt ist z. B. gültig). - Exceptions:
ArgumentNullExceptionfürnull-ArgumenteArgumentOutOfRangeExceptionfür ungültige Zahlparameter (NaN/Infinity, negative Toleranz,gridSize ≤ 0,QuadrantSegments < 1)InvalidOperationExceptionbei fehlender Factory (ADR 0004)NotSupportedExceptionfür unbekannteIGeometry2D-Typen oder nicht abbildbare Kombinationen in allgemeinen Overloads- Ungültige oder leere Geometrien werfen nie.
- Parameter: Ein Optionsobjekt gibt es nur ab mehr als zwei fachlichen Stellschrauben (
BufferOptions,OffsetOptions, ADR 0006), sonst einfache optionale Parameter. Die Reihenfolge ist immer: Pflichtparameter → fachliche Optionen →factory→gridSize.
Considered Options
- Centroid als
IPoint2Düber die Factory mit Exception bzw.TryCentroid(verworfen: Allokation für einen Wert) - Distance mit leerer Geometrie = 0 wie NTS (verworfen: mehrdeutig) oder Exception
- ConvexHull immer
IPolygon2D(verworfen: verliert die Entartungsinformation) - Simplify ohne Gültigkeitsgarantie (verworfen: widerspricht ADR 0003)