Euclid

Euclid is a 2D and 3D geometry library without dependencies. It is mostly focused on creating and manipulating primitives such as points, vectors, lines, planes, boxes, and bounding boxes, and polylines. For transformations of those there are rotations, quaternions, 4x4 and rigid ortho normal 4x3 matrices.

Written in F# and designed for use with F#. All primitive types are immutable and functions are curried where appropriate. This library is intended to be used for design, construction and manufacturing too. So it is using double precision floating point numbers for all values. (While most geometry libraries for games use single precision floats.)

This library can be compiled todo JavaScript via Fable too.

See Euclid.Rhino for converting form and to Rhino3D geometry.

Documentation

This library assumes a right handed coordinate system with the Z-axis pointing up. Just like Rhino3D, SketchUp, Revit, AutoCAD and Blender have it. But unlike Unity or Unreal Engine.

In this library a point is a position in space, a vector is a direction in space. A 4x4 transformation matrix applied to a vector will only rotate and scale the vector but not translate it. ( = Homogeneous coordinates)

For the full API see fuget.org for now.

License

MIT

Build

Just run dotnet build in the root directory.

Test

To just run once: dotnet run Tests\Euclid.Tests.fsproj To run and watch the tests use: dotnet watch --project Tests\Euclid.Tests.fsproj run

or:

cd Tests

For testing with .NET using Expecto run

dotnet run

for testing with Fable.Mocha run

npm test

Release Notes

0.7.0

• refactor offset
• add Topology sorting

0.6.1

• remove reflection form error messages for nicer Fable output
• rename Rect.Rotate to Rect.RotateOrientation
• add Rect.grid
• fix Rect.subdivide

0.5.0

• allow equality checks to use zero tolerance.
• better docstring
• add more angle calculation functions
• rename distanceFromPoint to distanceToPt
• add rotateByQuarterCircle
• add ExtendRel functions for Lines
• use *** as operator for dot product, and matrix multiplication
• add splitting with gap to Lines and Rects

0.4.1

• fix bug in rect.Edge23
• add BBox.createFromIList

0.4.0

• add Line.withLengthFromMid
• rename isAngleLessThan functions
• add spherical interpolation (slerp) for vectors
• rename Length to Width on Boxes and Rects
• rename Width to Height2D on Rects
• rename Width to Depth on Boxes
• add EdgeMethods on Rects and Boxes

0.3.0

• renamed OrthoMatrix to RigidMatrix
• add DataMember Attributes for serialization
• ofXZY functions renamed to createFromMembersXYZ
• add DivideByInt static members for Array.average and Array.sum for functions
• fixed typos, improve documentation

0.2.1

• fix fable support

0.2.0

• fable support
• improved xml documentation

0.1.0

• first public release

Fable build notes

Test is there is code using reflection via (or similar): dotnet fable --verbose --lang typescript --outDir ./dist/TS --noReflection