The unholy union of three.js and ndarrays


The unholy union of three.js and Mikola Lysenko's ndarrays.

It's far more efficient to just use gl-now. See the voxel-mipmap-demo. But if you would like to use ndarrays with three.js then this is the library for you.

See http://shama.github.io/ndthree.

// initialize our modules 
var ndthree = require('ndthree')
var ndarray = require('ndarray')
var fill = require('ndarray-fill')
var terrain = require('isabella-texture-pack')
var THREE = require('three')
// Create some random voxels in a sphere 
var voxels = ndarray(new Uint16Array(32*32*32), [32,32,32])
fill(voxels, function(i,j,k) {
  var x = Math.abs(- 16)
  var y = Math.abs(- 16)
  var z = Math.abs(- 16)
  // (1<<15) toggles ambient occlusion 
  return (x*x+y*y+z*z) < 190 ? ((Math.random()*255)|0) + (1<<15) : 0
// Create our buffer geometry and shader material 
var geometry = new THREE.BufferGeometry()
var material = new THREE.ShaderMaterial()
// Populate the geometry and material 
ndthree(voxels, geometry, material)
// Use helper for creating a mesh (optional) 
var mesh = ndthree.createMesh({
  geometry: geometry,
  material: material,
  map: terrain,
  size: 32,

var ndthree = require('ndthree')

  • ndarray should be 3 dimensional, eg [32, 32, 32].
  • geometry can be just an object but easier if a THREE.BufferGeometry.
  • material can be just an object but easier if a THREE.ShaderMaterial.

A helper for creating a three.js mesh from the previously created geometry and material.

  • options
    • THREE Pass in the instance of three.js. Required
    • geometry Pass in a THREE.BufferGeometry. Required
    • material Pass in a THREE.ShaderMaterial. Required
    • map|texture Pass in a ndarray texture tile map. Required
    • shape Shape of ndarray that generated the geometry. Used to offset the mesh position for centering. Default: [32, 32, 32]

Returns: A three.js mesh.

With npm do:

npm install ndthree

Use browserify to require('ndthree').

  • 0.1.0 - initial release

Copyright (c) 2013 Kyle Robinson Young
Licensed under the MIT license.