https://github.com/mikolalysenko/rle-csg

Constructive solid geometry for narrow band level sets
https://github.com/mikolalysenko/rle-csg

Last synced: about 2 months ago
JSON representation

Constructive solid geometry for narrow band level sets

• Host: GitHub
• URL: https://github.com/mikolalysenko/rle-csg
• Owner: mikolalysenko
• Created: 2013-01-14T18:35:22.000Z (almost 12 years ago)
• Default Branch: master
• Last Pushed: 2013-02-16T02:08:19.000Z (almost 12 years ago)
• Last Synced: 2024-10-20T14:27:56.181Z (2 months ago)
• Language: JavaScript
• Size: 520 KB
• Stars: 5
• Watchers: 3
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
rle-csg

=======

This library implements constructive solid geometry operations for narrowband level sets.  It is part of the [rle family of modules](https://github.com/mikolalysenko/rle-csg) for processing level sets.

Installation

============

Via npm:

    npm install rle-csg

Example

=======

Here is an example showing how to use the library:

    var core  = require("rle-core");

    var csg   = require("rle-csg");

    var cylinder = core.sampleSolid([-20, -20, -20], [20, 20, 20], function(x) {

        return Math.max(Math.abs(x[2]) - 15, Math.sqrt(x[0]*x[0] + x[1]*x[1]) - 5.5);

    });

    var box = core.sampleSolid([-10, -10, -10], [10, 10, 10], function(x) {

      return Math.max(Math.abs(x[0]), Math.abs(x[1]), Math.abs(x[2])) - 7.0;

    });

    var sphere = core.sampleSolid([-10,-10,-10], [10,10,10], function(x) {

      return Math.sqrt(x[0]*x[0]+x[1]*x[1]+x[2]*x[2]) - 8.0;

    });

    var shape = csg.subtract(csg.unite(box, cylinder), sphere);

Which gives you a shape that looks like this:

![](images/csg.png)

[If you want to see the result in 3D/WebGL, click here for an interactive demo](http://mikolalysenko.github.com/rle-csg/example/www/index.html)

API

===

To import the library, just do:

    var csg = require("rle-csg");

    

Or you can also just use the methods exposed by rle-all.  There are 4 functions exposed by this library:

## `csg.unite(a, b)`

Computes the set-theoretic union of solids a and b

## `csg.intersect(a, b)`

Intersects solids a and b

## `csg.subtract(a, b)`

Subtracts the solid a from b

## `csg.complement(a)`

Returns the complement of a

Credits

=======

(c) 2013 Mikola Lysenko.  BSD License