modeling/src/operations/booleans/scission.js

  1. const flatten = require('../../utils/flatten')
  3. // const geom2 = require('../../geometries/geom2')
  4. const geom3 = require('../../geometries/geom3')
  6. // const scissionGeom2 = require('./scissionGeom2')
  7. const scissionGeom3 = require('./scissionGeom3')
  9. /**
  10.  * Scission (divide) the given geometry into the component pieces.
  11.  *
  12.  * NOTE: Currently only 3D geometries are supported.
  13.  *
  14.  * @param {...Object} objects - list of geometries
  15.  * @returns {Array} list of pieces from each geometry
  16.  * @alias module:modeling/booleans.scission
  17.  *
  18.  * @example
  19.  * let figure = require('./my.stl')
  20.  * let pieces = scission(figure)
  21.  *
  22.  * @example
  23.  * +-------+            +-------+
  24.  * |       |            |       |
  25.  * |   +---+            | A +---+
  26.  * |   |    +---+   =   |   |    +---+
  27.  * +---+    |   |       +---+    |   |
  28.  *      +---+   |            +---+   |
  29.  *      |       |            |    B  |
  30.  *      +-------+            +-------+
  31.  */
  32. const scission = (...objects) => {
  33.   objects = flatten(objects)
  34.   if (objects.length === 0) throw new Error('wrong number of arguments')
  36.   const results = objects.map((object) => {
  37.     // if (path2.isA(object)) return path2.transform(matrix, object)
  38.     // if (geom2.isA(object)) return geom2.transform(matrix, object)
  39.     if (geom3.isA(object)) return scissionGeom3(object)
  40.     return object
  41.   })
  42.   return results.length === 1 ? results[0] : results
  43. }
  45. module.exports = scission