GeometryHelper 13.0.0

• .NETStandard 2.0

  • No dependencies.

NEW IN 13.0.0

     BREAKING, the DXF names
     - The DXF types move from GeometryHelper.Export to GeometryHelper.Dxf: a using GeometryHelper.Dxf; replaces or
       joins using GeometryHelper.Export; for DxfReader, DxfWriter, DxfDocument and every other Dxf type. ObjWriter,
       SvgWriter and Wkt stay in GeometryHelper.Export.
     - The reader's shape, DxfEntity, is DxfShape: DxfDocument.Shapes and DxfBlock.Shapes for Entities,
       DxfWriter.Add(DxfShape) and new DxfShape(...). DxfEntity is now the entity of the editing model, as AutoCAD
       names its own.
     - DxfGroup is DxfTypedValue, as AutoCAD's TypedValue: Code is TypeCode, a short, and Value is as it was.
       DxfGroup is now a GROUP of the drawing.
     - DxfUnits has AutoCAD's names, every number as it was: Undefined (was Unitless), Millimeters, Meters,
       MicroInches, Dekameters, Astronomical, USSurveyFeet and the rest. DxfReadOptions.ToMillimetres is
       ToMillimeters, and DxfShape.Colour, TrueColour and Lineweight are Color, TrueColor and LineWeight.
     - A reflection diff against 12.3.0 finds 119 public members removed, every one of them moved or renamed as
       above, and 3 168 added.

     BREAKING, three-point arcs
     - GeoArc2 and GeoArc3.FromThreePoints throw for many points nearly on one line that gave an arc before: of
       300 000 random triples at a thousandth, 35 100 of 45 415 arcs in the plane and 26 071 of 36 386 in space are
       refused. Catch the refusal and take the points as a line, or pass a tolerance of nought for the shallow arc.

     NEW, editing DXF drawings
     - DxfDatabase opens a DXF of R12 to R2018 to edit it as AutoCAD's Database edits a drawing: Open(path),
       Open(stream) or Parse(text), then Save(path), Save(stream) or ToText(). Saved with nothing changed, a file is
       written back byte for byte, comments, code page and the records the library does not read included; a change
       writes only the records it is about. 100 000 lines of 10.5 MB open and save in 36 ms on .NET 10.
     - The classes are AutoCAD's with Dxf in front, used directly, with no ObjectId and no transaction: ModelSpace,
       PaperSpace and the BlockTable of DxfBlockTableRecord; the layer, linetype, text style and dimension style
       tables; the header and AutoCAD's drawing variables by their names (Clayer, Ltscale, Dimasz and the rest);
       dictionaries, xrecords, groups, layouts, viewports, fields, annotation scales and the place on the earth.
     - Every entity of AutoCAD's name: DxfLine, DxfCircle, DxfArc, DxfEllipse, the three polylines, DxfSpline,
       DxfDBText, DxfMText, DxfBlockReference and its attributes, DxfHatch, DxfLeader, DxfMLeader, nine kinds of
       dimension, DxfTable and the meshes; a type with no class yet is a DxfUnknownEntity, kept as the file has it.
       Each is made in code (new DxfLine(start, end) { Layer = "steel" }), appended, erased, moved by TransformBy,
       copied, exploded, met by IntersectWith, joined by JoinEntity, and a curve walked by parameter and distance,
       offset, split and extended as AutoCAD does it.
     - Copies go between drawings as AutoCAD's deep clone takes them, by Clone and AppendEntity,
       WblockCloneObjects, Insert and AttachXref, bringing the blocks, layers and styles they name; a drawing of R12
       takes R12's forms, an MTEXT as one TEXT for each paragraph.
     - Held against ezdxf 1.4.5 on drawings of R12, R2000, R2007 and R2018: its recover and audit find nothing to
       fix in what is written, and it reads each value as set. The guide's DXF part is written for a reader who
       knows AutoCAD's .NET API, with a worked example and the points still to try in AutoCAD itself.

     NEW, reading DXF and shapes
     - DxfReader reads TEXT and MTEXT as the new DxfText, a LEADER as its curve and a MULTILEADER as the lines of
       its leaders, where it counted them in Skipped; DxfDocument.LayerTable and GetLayer give the layers with their
       look; DxfWriter.Add(DxfText) writes a text.
     - GeoCircle3 and GeoArc3 answer CollidesWith, GetIntersections and TryIntersectWith of a GeoEllipse3, as the
       ellipse answers them.

     FIXED, booleans and bodies
     - A union that came out wound against itself is worked out again, or says it was not worked out: a turned cube
       of 100 joined to a slab 0.001 thick inside its top is the cube, where it held 1 000 000.4. A difference or a
       common part enclosing no more than a slab the tolerance thick is nothing, BooleanOutcome.Empty.
     - TryCutOpenings, TrySplitBy, GetVolume and TryGetVolume give closed material or say false: a plate 300 by 200
       by 12 with twelve blind holes 0.015 under its top comes out closed, where 9 of 30 turnings were open, and a
       cracked cube 10 across with the corner of a box in it holds 875.00, where it held 1 000.
     - A boolean at a tolerance of nought returns, where 3 of 33 pairs ran for ever; a body 5E7 from the origin holds
       a point as one at the origin does; at a tolerance of nought a ray finds the crossing of each face it passes.

     FIXED, arcs, circles and ellipses in space
     - The distance to an arc, a curved edge or a curved chain is exact near the centre of a bend; a whole turn keeps
       every point of its circle whatever angle it starts at; GeoArc3.Translate moves a clockwise arc as it is.
     - GeoArc2 and GeoArc3.FromThreePoints read three points as on one line by the tolerance given, and give no arc
       that misses them; StartAngle is from nought up to a full turn however the arc was made; FromBulge past a half
       puts the centre where it is, 5E-12 off where it was 0.001.
     - Ellipses, circles and arcs that pass within the tolerance of each other touch, at both places where there are
       two, and give the same places whichever is asked first.

     FIXED, rays, segments, clash bars and labels
     - A ray meeting a triangle, a polygon or a face is read as its line is, TryIntersectWith agrees with
       GetIntersections, and a ray or segment that CollidesWith says touches is given the point.
     - ClashBar counts in LengthInside every stretch of its centre line within the tolerance of the part: a bar of
       radius 8 laid half its length on a box's top is 400 inside, where it was nought.
     - Arranger.Run reads the tolerance of its options throughout and arranges a scene moved elsewhere as it arranges
       it where it was.

     FIXED, offsets and splines
     - Offset2.Offset of a GeoPolygonArc2 drops a spike narrower than the tolerance, no longer comes back empty at a
       coarse tolerance, reads crossings nearer each other than the tolerance even-odd, and keeps the miter or chamfer
       at each tip where two lobes cross: the bow tie with an arc for its back, grown by 1, encloses 54.460, where its
       miter was cut off at 52.539.
     - Splines lying along each other give the same places however asked and turned, and a copy of a spline that
       crosses itself crosses it there; Flatten of a spline shorter than the tolerance no longer throws.
     - The copy of Clipper2 no longer overflows the stack on a polytree whose paths split off one another in a ring.

     CHANGED, behaviour you may notice
     - A union, a difference, a common part, TryCutOpenings or TrySplitBy can say false where it gave a body open or
       wound against itself. DxfReader refuses a file with letters beyond ASCII whose code page does not read ASCII
       as itself, and its size bound and MaxPlacedEntities, which now count texts and leaders, can refuse an INSERT
       placed before.
     - An edge bowing less off its chord than the rounding of its centre is its chord: IsArc is false.
     - Arranger.Run judges two labels closer than the tolerance as colliding, and ties go to the place tried first.

     CHANGED, speed
     - No longer slow with the square of their size: curved offsets and the crossings of a curved loop (a plus of
       80 000 teeth to each arm is cut in 0.75 to 1.6 s where it took 257 to 299), Clipper2 on combs, zigzags and
       rows of squares, booleans of faces lying back to back, ConvexHull3 and GeoObb3.Fit, merging faces of one
       plane, and clash bars by large meshes; the DXF model's inserts, erases, polylines and dimensions likewise.
       Results are the same to the bit.

     Details in CHANGELOG.md.

     Earlier releases: https://github.com/nguyenthanguth/GeometryHelper/blob/main/CHANGELOG.md