Package Exports

tess2-ts

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (tess2-ts) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

tess2-ts

Port of tess2.js to typescript

The tess2.js library performs polygon boolean operations and tesselation to triangles and convex polygons. It is a port of libtess2, which is turn is a cleaned up version of the stock GLU tesselator. The original code was written Eric Veach in 1994. The greatest thing about tess2.js is that it handles all kinds of input like self-intersecting polygons or any nomber of holes and contours.

Differences from tess2.js

Typescript
Include types
es6
Many errors has clear description
Allowed to disable validation passed to increase performance
Direct accces to Tesselator class

Installation:

npm install tess2-ts --save

Example use:

import {tesselate, WINDING, ELEMENT } from 'tess2-ts';

// Define input
var ca = [0,0, 10,0, 5,10];
var cb = [0,2, 10,2, 10,6, 0,6];
var contours = [ca,cb];

// Tesselate
var res = tesselate({
    contours: contours,
    windingRule: WINDING.ODD, // default
    elementType: ELEMENT.POLYGONS, // default
    polySize: 3, // default
    vertexSize: 2 // default
    strict: true // default, enable mesh validation 
});

// Use vertices
for (var i = 0; i < res.vertices.length; i += 2) {
    drawVertex(res.vertices[i], res.vertices[i+1]);
}
// Use triangles
for (var i = 0; i < res.elements.length; i += 3) {
    var a = res.elements[i], b = res.elements[i+1], c = res.elements[i+2];
    drawTriangle(res.vertices[a*2], res.vertices[a*2+1],
        res.vertices[b*2], res.vertices[b*2+1],
        res.vertices[c*2], res.vertices[c*2+1]);
}

Further reading: http://www.glprogramming.com/red/chapter11.html

Browser

like a simple script tag:

<script src="tess2.js"></script>
<script>
var res = Tess2.tesselate({ ... });

//same as above...
</script>

Building

To build, enter the following:

npm i
npm run build