Add support for BINVOX files

Author: andstor

package-lock.json

@@ -37,6 +37,7 @@
   "dependencies": {
     "@sh-dave/format-vox": "^0.1.5",
     "auto-bind": "^4.0.0",
+    "binvox": "^1.0.2",
     "iterator-result": "^1.0.0",
     "math-ds": ">= 1.0.0 < 2.0.0",
     "sparse-octree": "^6.0.2"

package.json

@@ -0,0 +1,88 @@
+/**
+ * @author André Storhaug <[email protected]>
+ */
+
+import autoBind from 'auto-bind';
+import { FileLoader, Loader, Vector3, LoadingManager } from 'three';
+import { PointOctree } from "sparse-octree";
+import { Parser } from 'binvox';
+import { levelOfDetail } from '../mixins/levelOfDetail';
+
+/**
+ * Class for loading voxel data stored in BINVOX files.
+ * @extends Loader
+ */
+class BINVOXLoader extends Loader {
+  /**
+   * Create a BINVOXLoader.
+   * @param {LoadingManager} manager
+   * @mixes levelOfDetail
+   */
+  constructor(manager) {
+    super(manager);
+    autoBind(this);
+    Object.assign(this, levelOfDetail);
+  }
+
+	/**
+	 * Loads and parses a BINVOX file from a URL.
+	 *
+	 * @param {String} url - URL to the BINVOX file.
+	 * @param {Function} [onLoad] - Callback invoked with the loaded object.
+	 * @param {Function} [onProgress] - Callback for download progress.
+	 * @param {Function} [onError] - Callback for download errors.
+	 */
+  load(url, onLoad, onProgress, onError) {
+    var scope = this;
+
+    var loader = new FileLoader(this.manager);
+    loader.setPath(this.path);
+    loader.setResponseType('arraybuffer')
+    loader.load(url, function (buffer) {
+
+      scope.parse(buffer)
+        .then(octree => onLoad(octree))
+        .catch(err => console.error(err))
+
+    }, onProgress, onError);
+  }
+
+	/**
+	 * Parse BINVOX file data.
+	 * @param {Buffer} buffer Content of BINVOX file.
+	 * @return {Promise<PointOctree>} Promise with an octree filled with voxel data.
+	 */
+  parse(buffer) {
+
+    return new Promise((resolve, reject) => {
+      const parser = new Parser();
+      let data = parser.parse(buffer);
+      console.log(data)
+      const depth = data.dimension.depth;
+      const width = data.dimension.width;
+      const height = data.dimension.height;
+
+      const min = new Vector3(-depth / 2, -height / 2, -width / 2);
+      const max = new Vector3(depth / 2, height / 2, width / 2);
+
+      const octree = new PointOctree(min, max, 0, this.LOD.maxPoints, this.LOD.maxDepth);
+      let voxelData = {};
+
+      data.voxels.forEach(voxel => {
+        let x, y, z;
+
+        x = voxel.x - (depth / 2);
+        y = voxel.y - (width / 2);
+        z = voxel.z - (height / 2);
+
+        let point = new Vector3(x, z, y);
+        octree.insert(point, voxelData);
+      });
+
+      resolve(octree);
+    });
+  }
+
+}
+
+export { BINVOXLoader };

src/loaders/BINVOXLoader.js

@@ -6,6 +6,7 @@ import { ArrayLoader } from "./ArrayLoader";
 import { OctreeLoader } from "./OctreeLoader";
 import { VOXLoader } from "./VOXLoader";
 import { XMLLoader } from "./XMLLoader";
+import { BINVOXLoader } from "./BINVOXLoader";
 
 /**
  * Factory class for creating various loaders.
@@ -30,6 +31,9 @@ class LoaderFactory {
       case 'xml':
         return new XMLLoader(this.manager);
         break;
+      case 'binvox':
+        return new BINVOXLoader(this.manager);
+        break;
       case 'array':
         return new ArrayLoader(this.manager);
         break;