0.2.0 • Published 11 years ago
ndthree v0.2.0
ndthree
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.
example
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(i - 16)
var y = Math.abs(j - 16)
var z = Math.abs(k - 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({
THREE: THREE,
geometry: geometry,
material: material,
map: terrain,
size: 32,
})
api
var ndthree = require('ndthree')
ndthree(ndarray, geometry, material)
ndarray
should be 3 dimensional, eg[32, 32, 32]
.geometry
can be just an object but easier if aTHREE.BufferGeometry
.material
can be just an object but easier if aTHREE.ShaderMaterial
.
ndthree.createMesh(options)
A helper for creating a three.js mesh from the previously created geometry and material.
options
THREE
Pass in the instance of three.js. Requiredgeometry
Pass in aTHREE.BufferGeometry
. Requiredmaterial
Pass in aTHREE.ShaderMaterial
. Requiredmap|texture
Pass in a ndarray texture tile map. Requiredshape
Shape of ndarray that generated the geometry. Used to offset the mesh position for centering. Default: 32, 32, 32
Returns: A three.js mesh.
install
With npm do:
npm install ndthree
Use browserify to require('ndthree')
.
release history
- 0.1.0 - initial release
license
Copyright (c) 2013 Kyle Robinson Young
Licensed under the MIT license.