Skip to content

πŸŽ²πŸ“ converts voxels into a set of triangles

License

Notifications You must be signed in to change notification settings

FlorianFe/voxel-triangulation.js

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

57 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

voxel-triangulation.js

converts voxels into a set of triangles using ndarray and libtess.js. It is used by the vox-viewer web component.

πŸ’Ύ Installation

npm install voxel-triangulation

πŸš€ Usage

  
  const ndarray = require('ndarray');
  const triangulateVoxels = require('voxel-triangulation');
  
  let values = [
    0, 1, 0, 
    0, 1, 2, 
    0, 1, 0,
    
    0, 1, 0, 
    0, 0, 2, 
    0, 1, 0,
    
    0, 1, 0, 
    0, 0, 2, 
    0, 0, 0
  ];
   
  let voxels = new ndarray(values, [3, 3, 3]);

  // gives list of voxel values which will be excluded (handled as void)
  let config = { exclude: [0] }; 

  let triangulation = triangulateVoxels(voxels, config);
  
  // outputs an object with vertices, normals, indices, uvs and voxel values of the triangles
  console.log(triangulation); 

  // vertices (3 entries for every vertex): [ v1.x, v1.y, v1.z,  v2.x, v2.y, v2.z,  ... ] 
  // normals (3 entries for every vertex): [ n1.x, n1.y, n1.z,  n2.x, n2.y, n2.z,  ... ]
  // indices (3 entries for every face): [ f1.a, f1.b, f1.c,  f2.a, f2.b, f2.c,  ... ] 
  // uvs (2 for every vertex): [ v1.u, v1.v, v2.u, v2.v, ... ] 
  // voxelValues (1 entry for every face): [ value1, value2, ... ]

πŸ‘€ Demo

You can see a live demo here

πŸ“– License

(c) 2019 Florian Fechner. MIT License

About

πŸŽ²πŸ“ converts voxels into a set of triangles

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published