# libtess

> Polygon tesselation library, ported from SGI's GLU implementation.

Latest version **1.2.2** (published 2015-12-19) · SGI-B-2.0 license · 0 weekly downloads

## Install

```sh
npm install libtess
pnpm add libtess
yarn add libtess
bun add libtess
```

## Health

**Score 23/100 (F)** — status: abandoned.

Positive: has types package; no vulnerabilities; high quality score.

Warnings: low downloads; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.2.2 |
| Published | 2015-12-19 |
| First published | 2013-12-05 |
| Weekly downloads | 0 |
| License | SGI-B-2.0 |
| TypeScript types | separate (@types/libtess) |
| Module format | CommonJS |
| Dependencies | 0 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 313 |
| Author | Brendan Kenny |
| Maintainers | skrat, brendankenny |
| Keywords | polygon, tesselation, tessellation, triangulation, GLUtesselator |

## Links

- npm: https://www.npmjs.com/package/libtess
- Repository: https://github.com/brendankenny/libtess.js
- Homepage: https://github.com/brendankenny/libtess.js/
- Issues: https://github.com/brendankenny/libtess.js/issues
- npm.io page: https://npm.io/package/libtess

## Recent versions

- 1.2.2 (latest) — 2015-12-19
- 1.2.1 — 2015-10-19
- 1.2.0 — 2014-11-23
- 1.1.0 — 2014-11-11
- 1.0.4 — 2014-09-29
- 1.0.3 — 2014-09-29
- 1.0.2 — 2014-01-07
- 1.0.1 — 2013-12-05
- 1.0.0 — 2013-12-05

## README

# libtess.js

[![Build Status](https://img.shields.io/travis/brendankenny/libtess.js/gh-pages.svg?style=flat-square)](https://travis-ci.org/brendankenny/libtess.js) [![Coverage Status](https://img.shields.io/coveralls/brendankenny/libtess.js/gh-pages.svg?style=flat-square)](https://coveralls.io/r/brendankenny/libtess.js?branch=gh-pages)

Polygon tesselation library, ported from the tesselator in Silicon Graphics's
[reference implementation](http://oss.sgi.com/projects/ogl-sample/index.html) of
the OpenGL Utility Library (GLU), written primarily by
[Eric Veach](https://www.youtube.com/watch?v=e3ss_Ozb9Yg) while at SGI.

## Installation

```
npm install libtess
```

## Example
See the [example page](https://brendankenny.github.io/libtess.js/examples/simple_triangulation/index.html)
for a simple example of setting up a polygon with a hole made of two contours,
triangulating it, and then drawing it with WebGL.

## Tests
Run the tests locally with `npm test`, or in the browser [here](https://brendankenny.github.io/libtess.js/test/index.html).

See the [expectations viewer](https://brendankenny.github.io/libtess.js/test/browser/expectations-viewer.html)
to compare the test geometry tessellated with the latest version of the library
versus the expected (baseline) tessellation.

## Tesselator or Tessellator?

Probably tessellator, but `GLUtesselator`, etc is in the original GLU API handed
down from Ancient Times and "tesselator" is already all over the original source
code, so that's what we're going with.

## License

Licensed under the
[SGI Free Software License B v2.0](https://github.com/brendankenny/libtess.js/blob/gh-pages/LICENSE).

This SGI license is not a common one, but the
[FSF has helped](https://www.fsf.org/blogs/licensing/2008-09-sgi-announcement)
bring it into equivalence with modern free software licenses, with terms
identical to that of the X11 License (MIT + "no-endorsement" clause). More
guidance [here](https://www.gnu.org/licenses/license-list.html#SGIFreeB).

---
_Source: https://npm.io/package/libtess · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._