Cura WASM Definitions

3D printer definitions for Cura WASM

Usage

import CuraWASM from 'cura-wasm';
import ResolveDefinition from 'cura-wasm-definitions';

const main = async () =>
{
  //Create a new slicer
  const slicer = new CuraWASM({
    /*
     * The 3D printer definition to slice for (See the src/definitions directory
     * or https://github.com/Ultimaker/Cura/tree/master/resources/definitions
     * for a list of built-in definitions)
     */
    definition: ResolveDefinition('ultimaker2'),
  });

  //Load your STL as an ArrayBuffer
  const res = await fetch('/demo/benchy.stl');
  const stl = await res.arrayBuffer();

  //Progress logger (Ranges from 0 to 100)
  slicer.on('progress', percent =>
  {
    console.log(`Progress: ${percent}%`);
  });

  //Slice (This can take multiple minutes to resolve!)
  const gcode = await slicer.slice(stl, 'stl');

  //Do something with the GCODE (ArrayBuffer)

  //Dispose (Reccomended but not necessary to call/intended for SPAs)
  slicer.dispose();
}
main();

How it works

When you call the default-exported function (ResolveDefinition in the above example), the function examines what printer definitions the requested definition depends on (eg: ultimaker2 depends on ultimaker which depends on fdmprinter which depends on fdmextruder). The function then recurs upon those parent definitions. There's also some logic for not resolving fdmextruder and fdmprinter definitions because these are bundled in Cura WASM itself (Because most printer definitions depend on them). Once it has walked the dependency hierarchy, the function squashes them together using Lodash's merge function and returns one combined definition.

What's the license?

Cura WASM Definitions relies on Cura (The upstream for 3D printer definitions) which which uses LGPL3+ hence the LGPL3+ license requirement. With that said, the LGPL3+ license only applies to tests/index.ts and all files in the src/definitions directory (Excluding src/definitions/index.ts). All other files use the MIT license.