README.md

cmmcore

⚠️ Warning:
This solution is in active development and far from complete, it does not implement a stable api and does not guarantee any backwards compatibility. Things can change. Use at your own risk.

The minimal, cutting-edge CAD engine.

Overview

Key Points

• Geometry data structures
  • cmmcore/vec.h: Data structure for 2d,3d,4d vectors with SIMD optimisations.
  • cmmcore/nurbs.h: Complete NURBS curves and surfaces implementation.
  • cmmcore/nurbs_utils.h: NURBS routines.
  • cmmcore/bvh.hpp BVH implementation.
• Numeric methods
  • cmmcore/newthon2.h: A good implementation of Newton's method and a few other useful functions.
  • cmmcore/integrate.h: Numeric integration.
• Robust intersection algorithms
  • cmmcore/ccx.h: curve x curve intersection algorithm (CCX). Works with NURBS curves.
  • cmmcore/csx.h: curve x surface intersection algorithm (CSX). Works with NURBS curves and NURBS surfaces.
  • cmmcore/ssx.h: surface x surface intersection algorithm (SSX). Work in progress.

Build

Native

cmmcore is a header-only library and therefore does not need to be compiled into a static or dynamic library. You can still do this with meson, but it is not required. The files in the test directories demonstrate how to use cmmcore in your own native executables. To build them run :

make 

Cython/Python

cmmcore reveals declarations in .pxd files. Which makes it also a cython library that you can use in your cython projects. An example of such use can be found in ./examples/cython_extension directory.

WASM

cmmcore can be compiled into wasm using emscripten.

WASM buindings are not complete at the moment, a lot of work is needed to make them usable. The bindings currently contains a few working examples and will be extended in the future.

To build and run the wasm module, follow these steps:

1. Make sure emscripten is installed and available in your environment

2. Go to the ./wasm directory

   cd wasm

3. Compile cmmcore.wasm and cmmcore.js:

   make

4. Run file server

   python3 -m http.server

   You'll see something like this:

   Serving HTTP on :: port 8000 (http://[::]:8000/) ...
   

5. In your browser, go to http://localhost:8000/index.html and open the browser console. In the browser console, you should see:

   Evaluated surface point: 0.386633295312500070.53927819546875010.3723660509375