GeometryHelper 13.4.0
See the version list below for details.
dotnet add package GeometryHelper --version 13.4.0
NuGet\Install-Package GeometryHelper -Version 13.4.0
<PackageReference Include="GeometryHelper" Version="13.4.0" />
<PackageVersion Include="GeometryHelper" Version="13.4.0" />
<PackageReference Include="GeometryHelper" />
paket add GeometryHelper --version 13.4.0
#r "nuget: GeometryHelper, 13.4.0"
#:package GeometryHelper@13.4.0
#addin nuget:?package=GeometryHelper&version=13.4.0
#tool nuget:?package=GeometryHelper&version=13.4.0
GeometryHelper
Geometry for engineering drawings and models, in two dimensions and in three, with the label placement
that runs on the 2D half. Written in C# and targeting netstandard2.0, so it loads into the
.NET Framework hosts that Tekla Structures and AutoCAD provide as well as into modern .NET.
Every comparison that floating point error can affect takes a Tolerance, because coordinates that come
out of a BIM model are never exact.
Use the default tolerance. The overloads without a tolerance read Tolerance.Global, which starts as
Tolerance.Default: a thousandth of a millimetre for points and for flatness, in a model in millimetres. That is as
exact as the corners of a modelled part are: two parts a hundredth apart are apart, and a thin overlap holds what it
holds. A finer tolerance cuts as slivers the few ten-thousandths a modeller's rounding leaves faces off flat and parts
apart, many times slower; a coarser one, passed to the call that needs it, takes what touches within it for touching.
Never new Tolerance(): made so, every threshold is 0. For parts drawn against each other, as a model's are, cut with a
SolidBooleanOptions whose Contact takes faces a hundredth apart for touching, and take a part's net body with
TrySubtractAll: within a thousandth alone, a part keeps a skin of itself where a cutter's face stood a few
thousandths inside it. A body read open, by copies of an edge a hair apart or by a face left out, is closed by
TryClose within a gap of its own, a hole filled only where asked, with a report of what it changed or why it would not.
Installation
dotnet add package GeometryHelper
Quick start
using GeometryHelper; // Tolerance, Angle, OffsetOptions
using GeometryHelper.Enums; // LineEnd, OffsetJoin, PointLocation
using GeometryHelper.Geometry; // every Geo type, 2D and 3D
using GeometryHelper.Core; // every operation
// In the plane: grow a slab, then cut an opening out of it.
var slab = new GeoPolygon2(new GeoPoint2(0, 0), new GeoPoint2(4000, 0),
new GeoPoint2(4000, 2000), new GeoPoint2(0, 2000));
var duct = new GeoPolygon2(new GeoPoint2(1000, 500), new GeoPoint2(1400, 500),
new GeoPoint2(1400, 900), new GeoPoint2(1000, 900));
GeoPolygon2 grown = slab.Offset(50.0)[0]; // 4100 x 2100
GeoFace2 pierced = Boolean2.Subtract(grown, duct)[0]; // one face, one hole
// In space: a beam trimmed where it runs into a wall.
var beam = new GeoLine3(new GeoPoint3(0, 0, 0), new GeoPoint3(3000, 0, 0));
var wall = new GeoPlane3(new GeoPoint3(2500, 0, 0), GeoVector3.XAxis);
beam.TryTrimTo(wall, LineEnd.End, out GeoLine3 cut); // (0,0,0) -> (2500,0,0)
What is inside
| Namespace | Holds |
|---|---|
GeometryHelper |
Tolerance, Angle, OffsetOptions, GeometryHelperLog, MassProperties3, MeasureComparison3 |
GeometryHelper.Enums |
PointLocation, PlaneSide, LineSide, LineEnd, LineExtension, OffsetJoin, VolumeMethod, AreaMethod |
GeometryHelper.Geometry |
30 immutable shapes: GeoPoint2 … GeoFace2 in the plane, GeoPoint3 … GeoSolid3 in space, arcs and the chains that carry them, and a transformation and a local coordinate system for each dimension |
GeometryHelper.Core |
35 operation classes, each dimension mirroring the other: Boolean2/Boolean3, Offset2/Offset3, Distance2/Distance3, … plus Arc2, Corner2 for chamfering and rounding, PlanarMap, which carries flat shapes between the two, and Measure3, a body's volume, mass and area read more than one way |
GeometryHelper.Spatial |
GeoBvh2 and GeoBvh3, the bounding volume hierarchies for large chains and meshes |
GeometryHelper.Extension |
turning raw point lists into geometry |
GeometryHelper.Arranging |
label placement: Arranger, ArrangeItem, ArrangeResult, ArrangeOptions, one greedy placement |
GeometryHelper.Meshing |
closed shapes of the plane and flat shapes of space broken into triangles, grids, strips or convex pieces, and bodies cut into the cells of a grid: GeoMesh2, Mesh2, GeoMesh3, Mesh3, MeshKind, MeshOptions, MeshPlacement3, GeoCellGrid3, GeoCell3, CellOptions3, CellAxis, GridAlignment |
GeometryHelper.Packing |
boxes onto sheets of paper: SheetPacker, Sheet, PackOptions, PackResult |
GeometryHelper.Export |
shapes written as OBJ, SVG and WKT: ObjWriter, SvgWriter, Wkt |
GeometryHelper.Dxf |
DXF files read into shapes (DxfReader, DxfDocument, DxfShape), shapes written (DxfWriter), and a drawing edited with AutoCAD's classes and members, Dxf in front: DxfDatabase, its tables and records, DxfBlockTableRecord, DxfEntity and every entity class |
Every operation is reachable both ways: the static form names the larger shape first, and the instance form sits on whichever of the two reads better where you are calling from.
Because both dimensions are one assembly, a flat shape in space can be laid out in its own plane, worked on with the whole 2D half of the library, and put back:
GeoCoordinateSystem3 frame = plate.GetFrame();
GeoFace2 flat = plate.ProjectToFace2(frame);
GeoFace3 back = flat.Subtract(openings)[0].ToFace3(frame);
Guides
The whole of it, searchable, with every type and member: https://nguyenthanguth.github.io/GeometryHelper/.
| Guide | Covers |
|---|---|
| Shared types | Tolerance, Angle, the enumerations, OffsetOptions, GeometryHelperLog; reading, writing and editing DXF files, the editing with AutoCAD's classes and members; a drawing edited step by step and the points to check in AutoCAD |
| Geometry in the plane | points to polygons and faces; extending, trimming, offsetting, combining regions |
| Meshing the plane | triangles, grids of panels or tiles with joints and alignment, strips and convex pieces, edge to edge |
| Geometry in space | points to solids; splitting, boolean bodies, meshes, local frames |
| Meshing in space | flat shapes of space in panels, tiles, strips and triangles; bodies and boxes cut into blocks, bays and lifts; the cases, drawn and checked |
| Label placement | labels placed greedily, clear of each other and of blocked regions |
| Packing boxes onto sheets | drawing views onto A0 to A4 sheets or sheets of a size of their own, a new sheet when one is full |
Coverage
dotnet test tests/GeometryHelper.UnitTest --collect:"XPlat Code Coverage"
writes a Cobertura file under TestResults. Only this library is counted.
Build and Test
dotnet build src/GeometryHelper/GeometryHelper.csproj
dotnet test tests/GeometryHelper.UnitTest/GeometryHelper.UnitTest.csproj
Warnings are errors in CI, and every public member is documented, so a missing XML comment or a stale
cref fails the build rather than landing quietly. Every example printed in the guides is also a test.
Licence
MIT. The clipping engine of Clipper2, by Angus Johnson, which is compiled into this package and resolves regions in the plane, is under the Boost Software License 1.0; THIRD-PARTY-NOTICES.md in the package holds its notice.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 was computed. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
| .NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
| .NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
| .NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
| MonoAndroid | monoandroid was computed. |
| MonoMac | monomac was computed. |
| MonoTouch | monotouch was computed. |
| Tizen | tizen40 was computed. tizen60 was computed. |
| Xamarin.iOS | xamarinios was computed. |
| Xamarin.Mac | xamarinmac was computed. |
| Xamarin.TVOS | xamarintvos was computed. |
| Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.0
- No dependencies.
NuGet packages (5)
Showing the top 5 NuGet packages that depend on GeometryHelper:
| Package | Downloads |
|---|---|
|
GeometryHelper.IfcConvert
Converts geometry between IFC (via xBIM) and GeometryHelper: points, vectors, matrices, faces, and solids. |
|
|
GeometryHelper.CadConvert
Converts geometry between AutoCAD and GeometryHelper: points, vectors, lines, polylines, polygons, circles, and bounding boxes. |
|
|
GeometryHelper.TeklaConvert.2026
Converts geometry between Tekla Structures 2026 and GeometryHelper: points, vectors, segments, planes, coordinate systems, bounding boxes, transformation matrices, and the faces and loops of a Tekla solid. Also reads the objects of IFC reference models into solids placed where Tekla shows them, through GeometryHelper.IfcConvert. Built for Tekla Structures 2026; install the package whose year matches your Tekla. |
|
|
GeometryHelper.TeklaConvert.2020
Converts geometry between Tekla Structures 2020 and GeometryHelper: points, vectors, segments, planes, coordinate systems, bounding boxes, transformation matrices, and the faces and loops of a Tekla solid. Also reads the objects of IFC reference models into solids placed where Tekla shows them, through GeometryHelper.IfcConvert. Built for Tekla Structures 2020; install the package whose year matches your Tekla. |
|
|
GeometryHelper.TeklaConvert.2025
Converts geometry between Tekla Structures 2025 and GeometryHelper: points, vectors, segments, planes, coordinate systems, bounding boxes, transformation matrices, and the faces and loops of a Tekla solid. Also reads the objects of IFC reference models into solids placed where Tekla shows them, through GeometryHelper.IfcConvert. Built for Tekla Structures 2025; install the package whose year matches your Tekla. |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 13.5.0 | 0 | 11/3/2026 |
| 13.4.0 | 0 | 11/2/2026 |
| 13.3.0 | 42 | 11/2/2026 |
| 13.2.0 | 52 | 11/1/2026 |
| 13.1.0 | 82 | 10/29/2026 |
| 13.0.0 | 104 | 10/28/2026 |
| 12.3.0 | 260 | 10/23/2026 |
| 12.2.0 | 263 | 10/14/2026 |
| 12.1.0 | 240 | 10/12/2026 |
| 12.0.0 | 258 | 10/7/2026 |
| 11.2.0 | 241 | 10/6/2026 |
| 11.1.0 | 256 | 10/6/2026 |
| 11.0.1 | 260 | 10/5/2026 |
| 11.0.0 | 276 | 10/5/2026 |
| 10.0.0 | 270 | 10/3/2026 |
| 9.0.2 | 270 | 10/1/2026 |
| 9.0.1 | 258 | 10/1/2026 |
| 9.0.0 | 265 | 10/1/2026 |
| 8.0.0 | 263 | 9/30/2026 |
| 7.0.0 | 250 | 9/29/2026 |
NEW IN 13.4.0
A minor release: no public member added, removed or renamed. Nearly all of it is DXF parity with AutoCAD 2021; the
results callers will see change are listed under CHANGED. The one fix outside DXF is in GeometryHelper.IfcConvert.
NEW, DXF
- DxfSpline.FitData fits by the parameters SqrtChord and Uniform too, as AutoCAD 2021 does, and FitData.KnotParam
reads them; only CustomParameterization is refused now.
CHANGED, DXF: results callers will see change
- An annotative TEXT, ATTRIB, ATTDEF, MTEXT or INSERT with contexts is read where AutoCAD 2021 shows it: its
place, turn and height (an MTEXT's box and attachment too, an INSERT's scale factors) are those of its context
of 1:1, else of its default, whatever CANNOSCALE says. Setters write the context read, and the record where it
is the default; the INSERT's ScaleFactors setter writes every context by its scale, 3 at 1:1 being 6 at 1:2;
TransformBy carries every context. A text with no context reads and writes as before.
- A copy (Clone, GetTransformedCopy) of an annotative text, attribute, MTEXT or INSERT keeps its original's
contexts. Clone of plain entities takes some 15 to 20 per cent longer.
- An ATTRIB is annotative as its INSERT is; an attribute made of several lines is held by the top of its MTEXT one
text height above its point, where it was held by its bottom left; TransformBy of an MTEXT stretches its box.
- DxfMLeader.BlockScale and BlockRotation set, even to the value they have, move the block so that a leader from
the left meets it at the base point and land its leaders anew; the library left the block where it was.
BlockRotation reads the multileader's own turn (43), where it read the turn the block is drawn with (46).
TransformBy leaves the multileader's own block scale and turn as they are: a block scaled by 2 reads a
BlockScale of 1. BlockPosition leaves the block's matrix as it is.
- A leader added by AddLeader has no landing until the first vertex given its line, which becomes its landing, the
content left where it is; SetDogleg lands a leader of no landing. Words given by MText bring their text style.
- The first edit of a DxfTable while its drawing is open merges first the rows AutoCAD 2021 merges when it loads a
file, a change of the table's own colour, layer and the like among the edits.
- DxfTable.ClearTableStyleOverrides keeps the title and header left out. Of 0 or 2 it sets the turn of a cell's
text or block back to nought, as RemoveAllOverrides does, and leaves a cell emptied in the session of no value;
of 2 it gives each cell the table's own looks of its row's kind. On a table of 400 rows a clear of 0 or 2 takes
20 ms on .NET Framework 4.8, where it took 8.
- DxfTable.ResetValue takes the looks of the content away with the value, and of a block cell makes a text cell of
no value, where it threw. From R2007 on, SetTextString of an empty text leaves no value as ResetValue does.
- DxfTable.Fill with CopyContent and CopyFrom from a cell emptied in the session leave the target's content as it
was; Fill above or left of its source and longer than it repeats the source from the fill range's far end; Fill
with CopyFormat turns a value of another kind into the source's.
- DxfTable.SetFormat keeps a format on a number alone, GetOverrides reads a cell's flag of its kind of value as
DataType | DataFormat, and the flags of merged and new cells and of a value's kind are written as AutoCAD writes
them.
- A DxfSpline read as the cubic through its fit points gives that cubic's Degree, ControlPoints, Knots, Weights
and NumControlPoints: five fit points alone of degree 2 are of degree 3 and 7 control points, where the library
gave 2 and none. ModifyPositionAndTangent and GetSplitCurves keep the fit points. The first geometry read of a
spline reads its record in one pass, in about half the time on .NET Framework 4.8.
FIXED, DXF
- DxfSpline.ToPolylineWithPrecision cuts a spline not periodic evenly where that gives more pieces than the
halving, as AutoCAD 2021 does; periodic fit data through three points give AutoCAD's periodic cubic.
- A multileader's leader moved off its landing is landed anew when the content is laid out again; a block mirrored
by TransformBy is drawn mirrored; a second leader on the right of a block moves it as AutoCAD moves it; words
that name a text style keep it when the multileader is added to a drawing.
Details in CHANGELOG.md.
Earlier releases: https://github.com/nguyenthanguth/GeometryHelper/blob/main/CHANGELOG.md