GeometryHelper 6.0.0

• .NETStandard 2.0

  • Clipper2 (>= 2.0.0)

NEW IN 6.0.0

     A summary. The full notes, with the reason and the measurement behind each item, and those of every
     earlier version: https://github.com/nguyenthanguth/GeometryHelper/blob/main/CHANGELOG.md

     BREAKING. Three changes, and no [Obsolete] forwarders left behind.
     - RENAMED. GetClosestOnBoundary(other) is GetShortestLineTo(other) on GeoLine2, GeoCircle2,
       GeoRectangle2, GeoPolygon2, GeoPolyline2 and GeoLine3, and Projection2.GetClosestSegment and
       Projection3.GetClosestSegment are GetShortestLineTo. On GeoPolygonArc2 and GeoPolylineArc2 the old
       method is GetClosestEdge, returning the GeoEdge2 it always meant.
     - MEASURED DIFFERENTLY. Whether an arc reaches a point of its own circle is judged as a distance, no
       longer within a whole degree of angle: DistanceTo no longer finds an arc nearer than its own points
       allow, and GetIntersections no longer finds crossings off the end of an arc.
     - RESHAPED. Label placement (GeometryHelper.Arranging): Arrange is ArrangeItem (Box, Leader, Offset),
       and Arrange.Run is Arranger.Run, which returns an ArrangeResult (Translation, Placed) per item
       instead of writing into the items. ArrangeOptions.Default is a new instance each time it is read.

     NEW
     - Nearest things from both sides: GetClosestEdge on the straight shapes, exact GetShortestLineTo on
       the curved ones, and GeoSolid3 measured against every shape in space.
     - SignedDistanceTo on the eight closed shapes: negative inside, nought on the boundary, positive
       outside, as Locate answers.
     - Arcs in space: GeoEdge3, GeoPolylineArc3 (a reinforcing bar), GeoPolygonArc3, Corner3.Fillet and
       arcs through PlanarMap; in GeometryHelper.TeklaConvert, ReinforcementConvert and
       RebarGeometryConvert. Crossings, collisions and cutting are exact; a curved chain is measured in
       space through ToPolyline3(chordTolerance).
     - Whichever of two shapes is in hand can be asked about the other: some fifty-five operations Core
       worked out and no type offered are now on the types, both ways round, GeoFace2 and GeoEdge2
       included.
     - The families that change geometry: regions in the plane cut by a line or a chain; arcs, chains,
       loops and edges extended and trimmed; fillets and chamfers for the straight shapes and in space;
       booleans on GeoPolygon3, GeoFace3 and GeoObb3; GeoPolylineArc3.OffsetInPlane; GeoObb3.TryExpand;
       GeoTriangle3.ToPolygon3 and ToFace3.
     - Chains in space answer CollidesWith, GetIntersections and TryIntersectWith; GeoFace2 and
       GeoRectangle2 gained TryIntersectWith; GeoLine3, GeoPolyline3, GeoRay3 and GeoEdge2 gained Locate.
     - Solid against solid: TryCutOpenings, TriangulateSurface, Intersect (one body per shared region),
       SplitShells and TryGetContact.
     - GeoSolid3.Prepare() and GeoPreparedSolid3, for a body asked many questions; Clash3.Find with
       ClashOptions, ClashResult and ClashKind.
     - Making bodies: Extrude, Cylinder, Pipe, Sweep and Revolve.
     - GetMassProperties, Section, ConvexHull2 and ConvexHull3, GeoRectangle2.Fit and GeoObb3.Fit.
     - IsValid on every value type, MakeValid for a polygon crossing itself, and Tolerance.Use scopes.
     - GeometryHelper.Export: ObjWriter, SvgWriter and Wkt.
     - StartPoint, EndPoint, MidPoint and TrySplitAtDistance across the four chains.

     FIXED
     - A body's openings are read as material everywhere: fifteen GeoSolid3 queries read the faces
       running across a hole, so a pin through a bolt hole was a clash.
     - Intersecting a bent bar took tens of seconds and could be wrong or throw; eight bent bars against a
       beam went from 57 s to 12 ms.
     - The solid booleans were wrong on about one pair in 250 where a body passed a few thousandths from a
       corner of the other, and could throw; they could also leave a sheet of no thickness inside their
       result, on which SplitShells threw.
     - Ear clipping meshed across the gaps of an I section's end and across the holes of a face carrying
       a row of points along an edge.
     - Two shapes lay in one plane when turned half a degree apart, and crossings under a degree were
       taken as parallel.
     - An arc or an edge was measured to a GeoCircle2's rim instead of its disc; two arcs are weighed all
       four ways round; a concave GeoPolygon3 is measured by triangles inside it, not by its fan.
     - NaN and infinity are refused wherever a negative size was.
     - IsClosed accepts watertight bodies whose edges are split, or shared by four faces.
     - GeometryHelperLog.Writer is called one message at a time.

     FASTER
     - The clash check: a steel frame of 789 parts with 400 bolt holes, prepared and checked, 9.7 s to
       2.0 s (7.3 s to 0.65 s under the server garbage collector); 80 crossing bars 3.0 s to 0.04 s; 2000
       boxes 39 ms to 3 ms. Every pair and kind of clash found is the same.

     EARLIER. 5.1.0 rounds each corner by its own radius; 5.0.0 made four packages one and brought arcs,
     chamfers, fillets and GeoTransform2. Both in full in the same file.