Voxelization of 3D models

Voxelizer is a JavaScript voxelization engine for conducting voxelization of 3D models. It does so by leveraging three.js and allowing you to use it's wast ecosystem of file loaders, plugins, etc.

Examples - Documentation - Wiki - Migration

• Install
  • As NPM package
  • Using a CDN
  • Peer Dependency
• Usage
  • Example
• Import support
• Export support
  • File formats
  • Data structures
• License
• Related

$ npm install voxelizer

You can import the latest standalone UMD build from a CDN such as:

<script src="https://unpkg.com/voxelizer/lib/voxelizer.js"></script>

If you want a specific version, use https://unpkg.com/react-dropdown-tree-select@<version>/lib/voxelizer.js Visit unpkg.com for further details.

In order to avoid version conflicts in your project, you must install three.js as a peer dependency. Note that NPM doesn't install peer dependencies automatically. Instead it will generate a warning message with instructions on how to install them.

If you're using the CDN build, you'd also need to add the peer dependency to your application.

<script src="https://unpkg.com/three/build/..."></script>

// Import via ES6 modules
import * as THREE from 'three';
import {Sampler, XMLExporter} from 'voxelizer';
// or UMD
const { Sampler, XMLExporter } = window.Voxelizer;


// Generate a yellow torus mesh to voxelize.
let geometry = new THREE.TorusGeometry( 10, 3, 16, 100 );
let material = new THREE.MeshBasicMaterial( { color: 0xffff00 } );
let torus = new THREE.Mesh( geometry, material );

// Setup Voxelizer.
let options = {
  fill: false,
  color: true
};
const sampler = new Sampler('raycast', options);

// Voxelize torus.
const resolution = 10;
let data = sampler.sample(torus, resolution);

// Export result to XML.
const exporter = new XMLExporter()
exporter.parse(data, function (xml) {
  console.log(xml)
});

Voxelizer is able to load any mesh created with three.js. By doing so, one can make use of the around 40 📄 file loaders provided by three.js, including support for the popular glTF, OBJ and STL formats.

three.js classifies these loaders as "examples". Please see the three.js documentation for how to use these.

Following is an example of how to load and voxelize a glTF file:

import {GLTFLoader} from 'three/examples/jsm/loaders/GLTFLoader';

// Setup voxelizer.
// ...

const gltfloader = new GLTFLoader();
gltfloader.load('path/to/file.glb', function (data) {
  let mesh = data.scene;
  let data = sampler.sample(mesh, resolution);
  
  // Do something with the data.
  // ...
});

Several file types and data structures are supported for exporting the voxel data.

• BINVOX
• XML

• ndarray
• 3D Array

Copyright © André Storhaug

Voxelizer is licensed under the MIT License.

• voxelizer-desktop - Easy 3D model voxelization desktop app
• three-voxel-loader - three.js plugin for loading voxel data