https://github.com/hughsk/unindex-mesh

Takes a list of vertices and faces, giving you back an array of individual triangles.
https://github.com/hughsk/unindex-mesh

Last synced: 12 days ago
JSON representation

Takes a list of vertices and faces, giving you back an array of individual triangles.

• Host: GitHub
• URL: https://github.com/hughsk/unindex-mesh
• Owner: hughsk
• License: mit
• Created: 2013-10-08T02:36:35.000Z (about 11 years ago)
• Default Branch: master
• Last Pushed: 2015-11-18T02:34:28.000Z (almost 9 years ago)
• Last Synced: 2024-10-17T16:40:53.002Z (22 days ago)
• Language: JavaScript
• Size: 4.88 KB
• Stars: 11
• Watchers: 4
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# unindex-mesh [![stable](http://hughsk.github.io/stability-badges/dist/stable.svg)](http://github.com/hughsk/stability-badges) #

Takes a list of vertices and faces, giving you back an array of individual

triangles.

In most cases with WebGL, you'll want to stick with indexed geometry - i.e.

providing a list of unique vertices and the faces that consume them, rather

then including a bunch of duplicate vertices to make each face. This way,

you consume less memory and *maybe* get some performance benefits too. That's

why modules like [bunny](http://npmjs.org/package/bunny) are formatted this

way.

One exemption to this case is if you want to for an intentionally flat

polygonal look. If you use indexed geometry you'll have forced interpolation

between your faces, getting rid of hard edges: this is normally a good thing,

but it spoils the low-poly look if that's what you're after.

So for interoperability/convenience this module can take indexes meshes and

output a `Float32Array` of individual triangles ready to send over to the GPU.

## Usage ##

[![unindex-mesh](https://nodei.co/npm/unindex-mesh.png?mini=true)](https://nodei.co/npm/unindex-mesh)

### `require('unindex-mesh')(positions, faces[, out])` ###

`positions` is an array of vertex positions and `faces` is a list of faces. The

number of points for each face and dimension of each position is determined by

the first position/face supplied.

`out` is an optional argument for including your own array to output the

result into. If not passed, a `Float32Array` of the correct length will

be created for you.

``` javascript

var faceNormals = require('mesh-normals')

var unindex = require('unindex-mesh')

var bunny = require('bunny')

var lowpoly = unindex(bunny.positions, bunny.cells)

var lowpolynormals = faceNormals(lowpoly)

```

### `require('unindex-mesh')(mesh[, out])`

Alternatively, you can pass in an object with the properties `positions` and

`cells` in place of the previous `positions` and `faces` arguments respectively.

``` javascript

var faceNormals = require('mesh-normals')

var unindex = require('unindex-mesh')

var lowpoly = unindex(require('bunny'))

var lowpolynormals = faceNormals(lowpoly)

```

## License ##

MIT. See [LICENSE.md](http://github.com/hughsk/unindex-mesh/blob/master/LICENSE.md) for details.