@cesium/engine 1.0.0 → 1.1.0

package/Source/Scene/VoxelBoxShape.js

@@ -0,0 +1,527 @@
+import BoundingSphere from "../Core/BoundingSphere.js";
+import Cartesian3 from "../Core/Cartesian3.js";
+import CesiumMath from "../Core/Math.js";
+import Check from "../Core/Check.js";
+import Matrix3 from "../Core/Matrix3.js";
+import Matrix4 from "../Core/Matrix4.js";
+import OrientedBoundingBox from "../Core/OrientedBoundingBox.js";
+import defaultValue from "../Core/defaultValue.js";
+
+/**
+ * A box {@link VoxelShape}.
+ *
+ * @alias VoxelBoxShape
+ * @constructor
+ *
+ * @see VoxelShape
+ * @see VoxelEllipsoidShape
+ * @see VoxelCylinderShape
+ * @see VoxelShapeType
+ *
+ * @private
+ */
+function VoxelBoxShape() {
+  /**
+   * An oriented bounding box containing the bounded shape.
+   * The update function must be called before accessing this value.
+   * @type {OrientedBoundingBox}
+   * @readonly
+   */
+  this.orientedBoundingBox = new OrientedBoundingBox();
+
+  /**
+   * A bounding sphere containing the bounded shape.
+   * The update function must be called before accessing this value.
+   * @type {BoundingSphere}
+   * @readonly
+   */
+  this.boundingSphere = new BoundingSphere();
+
+  /**
+   * A transformation matrix containing the bounded shape.
+   * The update function must be called before accessing this value.
+   * @type {Matrix4}
+   * @readonly
+   */
+  this.boundTransform = new Matrix4();
+
+  /**
+   * A transformation matrix containing the shape, ignoring the bounds.
+   * The update function must be called before accessing this value.
+   * @type {Matrix4}
+   * @readonly
+   */
+  this.shapeTransform = new Matrix4();
+
+  /**
+   * @type {Cartesian3}
+   * @private
+   */
+  this._minBounds = Cartesian3.clone(
+    VoxelBoxShape.DefaultMinBounds,
+    new Cartesian3()
+  );
+
+  /**
+   * @type {Cartesian3}
+   * @private
+   */
+  this._maxBounds = Cartesian3.clone(
+    VoxelBoxShape.DefaultMaxBounds,
+    new Cartesian3()
+  );
+
+  /**
+   * @type {Object.<string, any>}
+   * @readonly
+   */
+  this.shaderUniforms = {
+    boxUvToRenderBoundsTransform: new Matrix4(),
+    boxUvToRenderBoundsScale: new Cartesian3(),
+    boxUvToRenderBoundsTranslate: new Cartesian3(),
+    boxUvToShapeUvScale: new Cartesian3(),
+    boxUvToShapeUvTranslate: new Cartesian3(),
+  };
+
+  /**
+   * @type {Object.<string, any>}
+   * @readonly
+   */
+  this.shaderDefines = {
+    BOX_INTERSECTION_INDEX: undefined,
+    BOX_HAS_RENDER_BOUNDS: undefined,
+    BOX_HAS_SHAPE_BOUNDS: undefined,
+    BOX_IS_2D: undefined,
+  };
+
+  /**
+   * The maximum number of intersections against the shape for any ray direction.
+   * @type {Number}
+   * @readonly
+   */
+  this.shaderMaximumIntersectionsLength = 0; // not known until update
+}
+
+const scratchCenter = new Cartesian3();
+const scratchScale = new Cartesian3();
+const scratchRotation = new Matrix3();
+const scratchTransformLocalToBounds = new Matrix4();
+const scratchBoundsTranslation = new Cartesian3();
+const scratchBoundsScale = new Cartesian3();
+const scratchBoundsScaleMatrix = new Matrix3();
+const scratchClipMinBounds = new Cartesian3();
+const scratchClipMaxBounds = new Cartesian3();
+const scratchRenderMinBounds = new Cartesian3();
+const scratchRenderMaxBounds = new Cartesian3();
+
+const transformUvToLocal = Matrix4.fromRotationTranslation(
+  Matrix3.fromUniformScale(2.0, new Matrix3()),
+  new Cartesian3(-1.0, -1.0, -1.0),
+  new Matrix4()
+);
+
+const transformXYZToZYX = Matrix4.fromRotation(
+  Matrix3.fromColumnMajorArray(
+    [0.0, 0.0, 1.0, 0.0, 1.0, 0.0, 1.0, 0.0, 0.0],
+    new Matrix3()
+  ),
+  new Matrix4()
+);
+
+const transformXYZToXZY = Matrix4.fromRotation(
+  Matrix3.fromColumnMajorArray(
+    [1.0, 0.0, 0.0, 0.0, 0.0, 1.0, 0.0, 1.0, 0.0],
+    new Matrix3()
+  ),
+  new Matrix4()
+);
+
+/**
+ * Update the shape's state.
+ *
+ * @param {Matrix4} modelMatrix The model matrix.
+ * @param {Cartesian3} minBounds The minimum bounds.
+ * @param {Cartesian3} maxBounds The maximum bounds.
+ * @param {Cartesian3} [clipMinBounds=VoxelBoxShape.DefaultMinBounds] The minimum clip bounds.
+ * @param {Cartesian3} [clipMaxBounds=VoxelBoxShape.DefaultMaxBounds] The maximum clip bounds.
+ * @returns {Boolean} Whether the shape is visible.
+ */
+VoxelBoxShape.prototype.update = function (
+  modelMatrix,
+  minBounds,
+  maxBounds,
+  clipMinBounds,
+  clipMaxBounds
+) {
+  clipMinBounds = defaultValue(clipMinBounds, VoxelBoxShape.DefaultMinBounds);
+  clipMaxBounds = defaultValue(clipMaxBounds, VoxelBoxShape.DefaultMaxBounds);
+  //>>includeStart('debug', pragmas.debug);
+  Check.typeOf.object("modelMatrix", modelMatrix);
+  Check.typeOf.object("minBounds", minBounds);
+  Check.typeOf.object("maxBounds", maxBounds);
+  //>>includeEnd('debug');
+
+  const defaultMinBounds = VoxelBoxShape.DefaultMinBounds;
+  const defaultMaxBounds = VoxelBoxShape.DefaultMaxBounds;
+
+  minBounds = this._minBounds = Cartesian3.clamp(
+    minBounds,
+    defaultMinBounds,
+    defaultMaxBounds,
+    this._minBounds
+  );
+
+  maxBounds = this._maxBounds = Cartesian3.clamp(
+    maxBounds,
+    defaultMinBounds,
+    defaultMaxBounds,
+    this._maxBounds
+  );
+
+  clipMinBounds = Cartesian3.clamp(
+    clipMinBounds,
+    defaultMinBounds,
+    defaultMaxBounds,
+    scratchClipMinBounds
+  );
+
+  clipMaxBounds = Cartesian3.clamp(
+    clipMaxBounds,
+    defaultMinBounds,
+    defaultMaxBounds,
+    scratchClipMaxBounds
+  );
+
+  const renderMinBounds = Cartesian3.clamp(
+    minBounds,
+    clipMinBounds,
+    clipMaxBounds,
+    scratchRenderMinBounds
+  );
+
+  const renderMaxBounds = Cartesian3.clamp(
+    maxBounds,
+    clipMinBounds,
+    clipMaxBounds,
+    scratchRenderMaxBounds
+  );
+
+  const scale = Matrix4.getScale(modelMatrix, scratchScale);
+
+  // Box is not visible if:
+  // - any of the min render bounds exceed the max render bounds
+  // - two or more of the min bounds equal the max bounds (line / point)
+  // - any of the min clip bounds exceed the max clip bounds
+  // - scale is 0 for any component (too annoying to reconstruct rotation matrix)
+  if (
+    renderMinBounds.x > renderMaxBounds.x ||
+    renderMinBounds.y > renderMaxBounds.y ||
+    renderMinBounds.z > renderMaxBounds.z ||
+    (renderMinBounds.x === renderMaxBounds.x) +
+      (renderMinBounds.y === renderMaxBounds.y) +
+      (renderMinBounds.z === renderMaxBounds.z) >=
+      2 ||
+    clipMinBounds.x > clipMaxBounds.x ||
+    clipMinBounds.y > clipMaxBounds.y ||
+    clipMinBounds.z > clipMaxBounds.z ||
+    scale.x === 0.0 ||
+    scale.y === 0.0 ||
+    scale.z === 0.0
+  ) {
+    return false;
+  }
+
+  this.shapeTransform = Matrix4.clone(modelMatrix, this.shapeTransform);
+
+  this.orientedBoundingBox = getBoxChunkObb(
+    renderMinBounds,
+    renderMaxBounds,
+    this.shapeTransform,
+    this.orientedBoundingBox
+  );
+
+  // All of the box bounds go from -1 to +1, so the model matrix scale can be
+  // used as the oriented bounding box half axes.
+  this.boundTransform = Matrix4.fromRotationTranslation(
+    this.orientedBoundingBox.halfAxes,
+    this.orientedBoundingBox.center,
+    this.boundTransform
+  );
+
+  this.boundingSphere = BoundingSphere.fromOrientedBoundingBox(
+    this.orientedBoundingBox,
+    this.boundingSphere
+  );
+
+  const shaderUniforms = this.shaderUniforms;
+  const shaderDefines = this.shaderDefines;
+
+  // To keep things simple, clear the defines every time
+  for (const key in shaderDefines) {
+    if (shaderDefines.hasOwnProperty(key)) {
+      shaderDefines[key] = undefined;
+    }
+  }
+
+  const hasRenderBounds =
+    renderMinBounds.x !== defaultMinBounds.x ||
+    renderMaxBounds.x !== defaultMaxBounds.x ||
+    renderMinBounds.y !== defaultMinBounds.y ||
+    renderMaxBounds.y !== defaultMaxBounds.y ||
+    renderMinBounds.z !== defaultMinBounds.z ||
+    renderMaxBounds.z !== defaultMaxBounds.z;
+
+  const hasShapeBounds =
+    minBounds.x !== defaultMinBounds.x ||
+    maxBounds.x !== defaultMaxBounds.x ||
+    minBounds.y !== defaultMinBounds.y ||
+    maxBounds.y !== defaultMaxBounds.y ||
+    minBounds.z !== defaultMinBounds.z ||
+    maxBounds.z !== defaultMaxBounds.z;
+
+  // Keep track of how many intersections there are going to be.
+  let intersectionCount = 0;
+
+  shaderDefines["BOX_INTERSECTION_INDEX"] = intersectionCount;
+  intersectionCount += 1;
+
+  if (hasRenderBounds) {
+    shaderDefines["BOX_HAS_RENDER_BOUNDS"] = true;
+
+    const min = renderMinBounds;
+    const max = renderMaxBounds;
+
+    // inverse(scale)
+    // inverse(maxBoundsUv - minBoundsUv)
+    // inverse((maxBounds * 0.5 + 0.5) - (minBounds * 0.5 + 0.5))
+    // inverse(0.5 * (maxBounds - minBounds))
+    // 2.0 / (maxBounds - minBounds) // with divide by zero protection
+    const scaleLocalToBounds = Cartesian3.fromElements(
+      2.0 / (min.x === max.x ? 1.0 : max.x - min.x),
+      2.0 / (min.y === max.y ? 1.0 : max.y - min.y),
+      2.0 / (min.z === max.z ? 1.0 : max.z - min.z),
+      scratchBoundsScale
+    );
+
+    // -inverse(scale) * translation // affine inverse
+    // -inverse(scale) * 0.5 * (minBounds + maxBounds)
+    const translateLocalToBounds = Cartesian3.fromElements(
+      -scaleLocalToBounds.x * 0.5 * (min.x + max.x),
+      -scaleLocalToBounds.y * 0.5 * (min.y + max.y),
+      -scaleLocalToBounds.z * 0.5 * (min.z + max.z),
+      scratchBoundsTranslation
+    );
+
+    let transformLocalToBounds = Matrix4.fromRotationTranslation(
+      Matrix3.fromScale(scaleLocalToBounds, scratchBoundsScaleMatrix),
+      translateLocalToBounds,
+      scratchTransformLocalToBounds
+    );
+
+    if (min.x === max.x || min.y === max.y || min.z === max.z) {
+      shaderDefines["BOX_IS_2D"] = true;
+
+      let transformAxisConversion;
+      if (min.x === max.x) {
+        transformAxisConversion = transformXYZToZYX;
+      } else if (min.y === max.y) {
+        transformAxisConversion = transformXYZToXZY;
+      } else if (min.z === max.z) {
+        transformAxisConversion = Matrix4.IDENTITY;
+      }
+      transformLocalToBounds = Matrix4.multiplyTransformation(
+        transformAxisConversion,
+        transformLocalToBounds,
+        transformLocalToBounds
+      );
+    }
+
+    shaderUniforms.boxUvToRenderBoundsTransform = Matrix4.multiplyTransformation(
+      transformLocalToBounds,
+      transformUvToLocal,
+      shaderUniforms.boxUvToRenderBoundsTransform
+    );
+    shaderUniforms.boxUvToRenderBoundsScale = Matrix4.getScale(
+      shaderUniforms.boxUvToRenderBoundsTransform,
+      shaderUniforms.boxUvToRenderBoundsScale
+    );
+    shaderUniforms.boxUvToRenderBoundsTranslate = Matrix4.getTranslation(
+      shaderUniforms.boxUvToRenderBoundsTransform,
+      shaderUniforms.boxUvToRenderBoundsTranslate
+    );
+  }
+
+  if (hasShapeBounds) {
+    shaderDefines["BOX_HAS_SHAPE_BOUNDS"] = true;
+
+    const min = minBounds;
+    const max = maxBounds;
+
+    // Go from UV space to bounded UV space:
+    // delerp(posUv, minBoundsUv, maxBoundsUv)
+    // (posUv - minBoundsUv) / (maxBoundsUv - minBoundsUv)
+    // posUv / (maxBoundsUv - minBoundsUv) - minBoundsUv / (maxBoundsUv - minBoundsUv)
+    // scale = 1.0 / (maxBoundsUv - minBoundsUv)
+    // scale = 1.0 / ((maxBounds * 0.5 + 0.5) - (minBounds * 0.5 + 0.5))
+    // scale = 2.0 / (maxBounds - minBounds)
+    // offset = -minBoundsUv / ((maxBounds * 0.5 + 0.5) - (minBounds * 0.5 + 0.5))
+    // offset = -2.0 * (minBounds * 0.5 + 0.5) / (maxBounds - minBounds)
+    // offset = -scale * (minBounds * 0.5 + 0.5)
+    shaderUniforms.boxUvToShapeUvScale = Cartesian3.fromElements(
+      2.0 / (min.x === max.x ? 1.0 : max.x - min.x),
+      2.0 / (min.y === max.y ? 1.0 : max.y - min.y),
+      2.0 / (min.z === max.z ? 1.0 : max.z - min.z),
+      shaderUniforms.boxUvToShapeUvScale
+    );
+
+    shaderUniforms.boxUvToShapeUvTranslate = Cartesian3.fromElements(
+      -shaderUniforms.boxUvToShapeUvScale.x * (min.x * 0.5 + 0.5),
+      -shaderUniforms.boxUvToShapeUvScale.y * (min.y * 0.5 + 0.5),
+      -shaderUniforms.boxUvToShapeUvScale.z * (min.z * 0.5 + 0.5),
+      shaderUniforms.boxUvToShapeUvTranslate
+    );
+  }
+
+  this.shaderMaximumIntersectionsLength = intersectionCount;
+
+  return true;
+};
+
+const scratchTileMinBounds = new Cartesian3();
+const scratchTileMaxBounds = new Cartesian3();
+
+/**
+ * Computes an oriented bounding box for a specified tile.
+ * The update function must be called before calling this function.
+ *
+ * @param {Number} tileLevel The tile's level.
+ * @param {Number} tileX The tile's x coordinate.
+ * @param {Number} tileY The tile's y coordinate.
+ * @param {Number} tileZ The tile's z coordinate.
+ * @param {OrientedBoundingBox} result The oriented bounding box that will be set to enclose the specified tile
+ * @returns {OrientedBoundingBox} The oriented bounding box.
+ */
+VoxelBoxShape.prototype.computeOrientedBoundingBoxForTile = function (
+  tileLevel,
+  tileX,
+  tileY,
+  tileZ,
+  result
+) {
+  //>>includeStart('debug', pragmas.debug);
+  Check.typeOf.number("tileLevel", tileLevel);
+  Check.typeOf.number("tileX", tileX);
+  Check.typeOf.number("tileY", tileY);
+  Check.typeOf.number("tileZ", tileZ);
+  Check.typeOf.object("result", result);
+  //>>includeEnd('debug');
+
+  const minBounds = this._minBounds;
+  const maxBounds = this._maxBounds;
+  const sizeAtLevel = 1.0 / Math.pow(2, tileLevel);
+
+  const tileMinBounds = Cartesian3.fromElements(
+    CesiumMath.lerp(minBounds.x, maxBounds.x, sizeAtLevel * tileX),
+    CesiumMath.lerp(minBounds.y, maxBounds.y, sizeAtLevel * tileY),
+    CesiumMath.lerp(minBounds.z, maxBounds.z, sizeAtLevel * tileZ),
+    scratchTileMinBounds
+  );
+
+  const tileMaxBounds = Cartesian3.fromElements(
+    CesiumMath.lerp(minBounds.x, maxBounds.x, sizeAtLevel * (tileX + 1)),
+    CesiumMath.lerp(minBounds.y, maxBounds.y, sizeAtLevel * (tileY + 1)),
+    CesiumMath.lerp(minBounds.z, maxBounds.z, sizeAtLevel * (tileZ + 1)),
+    scratchTileMaxBounds
+  );
+
+  return getBoxChunkObb(
+    tileMinBounds,
+    tileMaxBounds,
+    this.shapeTransform,
+    result
+  );
+};
+
+/**
+ * Computes an approximate step size for raymarching the root tile of a voxel grid.
+ * The update function must be called before calling this function.
+ *
+ * @param {Cartesian3} dimensions The voxel grid dimensions for a tile.
+ * @returns {Number} The step size.
+ */
+VoxelBoxShape.prototype.computeApproximateStepSize = function (dimensions) {
+  //>>includeStart('debug', pragmas.debug);
+  Check.typeOf.object("dimensions", dimensions);
+  //>>includeEnd('debug');
+
+  return 1.0 / Cartesian3.maximumComponent(dimensions);
+};
+
+/**
+ * Defines the minimum bounds of the shape. Corresponds to minimum X, Y, Z.
+ *
+ * @type {Cartesian3}
+ * @constant
+ * @readonly
+ */
+VoxelBoxShape.DefaultMinBounds = Object.freeze(
+  new Cartesian3(-1.0, -1.0, -1.0)
+);
+
+/**
+ * Defines the maximum bounds of the shape. Corresponds to maximum X, Y, Z.
+ *
+ * @type {Cartesian3}
+ * @constant
+ * @readonly
+ */
+VoxelBoxShape.DefaultMaxBounds = Object.freeze(
+  new Cartesian3(+1.0, +1.0, +1.0)
+);
+
+/**
+ * Computes an {@link OrientedBoundingBox} for a subregion of the shape.
+ *
+ * @function
+ *
+ * @param {Cartesian3} minimumBounds The minimum bounds, in the local coordinates of the shape.
+ * @param {Cartesian3} maximumBounds The maximum bounds, in the local coordinates of the shape.
+ * @param {Matrix4} matrix The matrix to transform the points.
+ * @param {OrientedBoundingBox} result The object onto which to store the result.
+ * @returns {OrientedBoundingBox} The oriented bounding box that contains this subregion.
+ *
+ * @private
+ */
+function getBoxChunkObb(minimumBounds, maximumBounds, matrix, result) {
+  const defaultMinBounds = VoxelBoxShape.DefaultMinBounds;
+  const defaultMaxBounds = VoxelBoxShape.DefaultMaxBounds;
+
+  const isDefaultBounds =
+    Cartesian3.equals(minimumBounds, defaultMinBounds) &&
+    Cartesian3.equals(maximumBounds, defaultMaxBounds);
+
+  if (isDefaultBounds) {
+    result.center = Matrix4.getTranslation(matrix, result.center);
+    result.halfAxes = Matrix4.getMatrix3(matrix, result.halfAxes);
+  } else {
+    let scale = Matrix4.getScale(matrix, scratchScale);
+    const localCenter = Cartesian3.midpoint(
+      minimumBounds,
+      maximumBounds,
+      scratchCenter
+    );
+    result.center = Matrix4.multiplyByPoint(matrix, localCenter, result.center);
+    scale = Cartesian3.fromElements(
+      scale.x * 0.5 * (maximumBounds.x - minimumBounds.x),
+      scale.y * 0.5 * (maximumBounds.y - minimumBounds.y),
+      scale.z * 0.5 * (maximumBounds.z - minimumBounds.z),
+      scratchScale
+    );
+    const rotation = Matrix4.getRotation(matrix, scratchRotation);
+    result.halfAxes = Matrix3.setScale(rotation, scale, result.halfAxes);
+  }
+
+  return result;
+}
+
+export default VoxelBoxShape;

package/Source/Scene/VoxelContent.js

@@ -0,0 +1,169 @@
+import Check from "../Core/Check.js";
+import DeveloperError from "../Core/DeveloperError.js";
+import defined from "../Core/defined.js";
+import getJsonFromTypedArray from "../Core/getJsonFromTypedArray.js";
+import MetadataTable from "./MetadataTable.js";
+
+/**
+ * An object representing voxel content for a {@link Cesium3DTilesVoxelProvider}.
+ *
+ * @alias VoxelContent
+ * @constructor
+ *
+ * @param {Resource} resource The resource for this voxel content. This is used for fetching external buffers as needed.
+ * @param {Object} [json] Voxel JSON contents. Mutually exclusive with binary.
+ * @param {Uint8Array} [binary] Voxel binary contents. Mutually exclusive with json.
+ * @param {MetadataSchema} metadataSchema The metadata schema used by property tables in the voxel content
+ *
+ * @exception {DeveloperError} One of json and binary must be defined.
+ *
+ * @private
+ * @experimental This feature is not final and is subject to change without Cesium's standard deprecation policy.
+ */
+function VoxelContent(resource, json, binary, metadataSchema) {
+  //>>includeStart('debug', pragmas.debug);
+  Check.typeOf.object("resource", resource);
+  if (defined(json) === defined(binary)) {
+    throw new DeveloperError("One of json and binary must be defined.");
+  }
+  //>>includeEnd('debug');
+
+  this._resource = resource;
+  this._metadataTable = undefined;
+
+  let chunks;
+  if (defined(json)) {
+    chunks = {
+      json: json,
+      binary: undefined,
+    };
+  } else {
+    chunks = parseVoxelChunks(binary);
+  }
+
+  this._readyPromise = initialize(
+    this,
+    chunks.json,
+    chunks.binary,
+    metadataSchema
+  );
+}
+
+Object.defineProperties(VoxelContent.prototype, {
+  /**
+   * A promise that resolves once all buffers are loaded.
+   *
+   * @type {Promise}
+   * @readonly
+   * @private
+   */
+  readyPromise: {
+    get: function () {
+      return this._readyPromise;
+    },
+  },
+
+  /**
+   * The {@link MetadataTable} storing voxel property values.
+   *
+   * @type {MetadataTable}
+   * @readonly
+   * @private
+   */
+  metadataTable: {
+    get: function () {
+      return this._metadataTable;
+    },
+  },
+});
+
+function initialize(content, json, binary, metadataSchema) {
+  return requestBuffers(content, json, binary).then(function (buffersU8) {
+    const bufferViewsU8 = {};
+    const bufferViewsLength = json.bufferViews.length;
+    for (let i = 0; i < bufferViewsLength; ++i) {
+      const bufferViewJson = json.bufferViews[i];
+      const start = bufferViewJson.byteOffset;
+      const end = start + bufferViewJson.byteLength;
+      const buffer = buffersU8[bufferViewJson.buffer];
+      const bufferView = buffer.subarray(start, end);
+      bufferViewsU8[i] = bufferView;
+    }
+
+    const propertyTableIndex = json.voxelTable;
+    const propertyTableJson = json.propertyTables[propertyTableIndex];
+    content._metadataTable = new MetadataTable({
+      count: propertyTableJson.count,
+      properties: propertyTableJson.properties,
+      class: metadataSchema.classes[propertyTableJson.class],
+      bufferViews: bufferViewsU8,
+    });
+    return content;
+  });
+}
+
+function requestBuffers(content, json, binary) {
+  const buffersLength = json.buffers.length;
+  const bufferPromises = new Array(buffersLength);
+  for (let i = 0; i < buffersLength; i++) {
+    const buffer = json.buffers[i];
+    if (defined(buffer.uri)) {
+      const baseResource = content._resource;
+      const bufferResource = baseResource.getDerivedResource({
+        url: buffer.uri,
+      });
+      bufferPromises[i] = bufferResource
+        .fetchArrayBuffer()
+        .then(function (arrayBuffer) {
+          return new Uint8Array(arrayBuffer);
+        });
+    } else {
+      bufferPromises[i] = Promise.resolve(binary);
+    }
+  }
+
+  return Promise.all(bufferPromises);
+}
+
+/**
+ * A helper object for storing the two parts of the binary voxel content
+ *
+ * @typedef {Object} VoxelChunks
+ * @property {Object} json The json chunk of the binary voxel content
+ * @property {Uint8Array} binary The binary chunk of the binary voxel content. This represents the internal buffer.
+ * @private
+ */
+
+/**
+ * Given binary voxel content, split into JSON and binary chunks
+ *
+ * @param {Uint8Array} binaryView The binary voxel content
+ * @returns {VoxelChunks} An object containing the JSON and binary chunks
+ * @private
+ */
+function parseVoxelChunks(binaryView) {
+  // Parse the header
+  const littleEndian = true;
+  const reader = new DataView(binaryView.buffer, binaryView.byteOffset);
+  // Skip to the chunk lengths
+  let byteOffset = 8;
+
+  // Read the bottom 32 bits of the 64-bit byte length. This is ok for now because:
+  // 1) not all browsers have native 64-bit operations
+  // 2) the data is well under 4GB
+  const jsonByteLength = reader.getUint32(byteOffset, littleEndian);
+  byteOffset += 8;
+  const binaryByteLength = reader.getUint32(byteOffset, littleEndian);
+  byteOffset += 8;
+
+  const json = getJsonFromTypedArray(binaryView, byteOffset, jsonByteLength);
+  byteOffset += jsonByteLength;
+  const binary = binaryView.subarray(byteOffset, byteOffset + binaryByteLength);
+
+  return {
+    json: json,
+    binary: binary,
+  };
+}
+
+export default VoxelContent;