@woosh/meep-engine 2.48.19 → 2.48.21

package/src/engine/graphics/micron/format/serialization/MicronGeometryBinarySerializationAdapter.js

@@ -1,123 +0,0 @@
-import { BinaryClassSerializationAdapter } from "../../../../ecs/storage/binary/BinaryClassSerializationAdapter.js";
-import { MicronGeometry } from "../MicronGeometry.js";
-import { AttributeSpec } from "../../../geometry/AttributeSpec.js";
-import { MicronGeometryPatch } from "../MicronGeometryPatch.js";
-import { serialize_patch } from "./serialize_patch.js";
-import { deserialize_patch } from "./deserialize_patch.js";
-import { serialize_attribute_spec } from "./serialize_attribute_spec.js";
-import { deserialize_attribute_spec } from "./deserialize_attribute_spec.js";
-
-export class MicronGeometryBinarySerializationAdapter extends BinaryClassSerializationAdapter {
-    constructor() {
-        super();
-
-        this.klass = MicronGeometry;
-        this.version = 0;
-    }
-
-    /**
-     *
-     * @param {BinaryBuffer} buffer
-     * @param {MicronGeometry} value
-     */
-    serialize(buffer, value) {
-        const spec = value.vertex_spec;
-
-        // serialize vertex spec
-        const attributes = spec.attributes;
-        const attribute_count = attributes.length;
-        buffer.writeUintVar(attribute_count);
-        for (let i = 0; i < attribute_count; i++) {
-            const attribute = attributes[i];
-
-            serialize_attribute_spec(buffer, attribute);
-        }
-
-        // serialize patches
-
-        /**
-         *
-         * @type {MicronGeometryPatch[]}
-         */
-        const patches = value.patches;
-        const patch_count = patches.length;
-
-        const root_patch_index = patches.indexOf(value.root);
-
-        buffer.writeUintVar(root_patch_index);
-
-        buffer.writeUintVar(patch_count);
-
-        for (let i = 0; i < patch_count; i++) {
-            serialize_patch(buffer, patches[i], spec, patches);
-        }
-    }
-
-    /**
-     *
-     * @param {BinaryBuffer} buffer
-     * @param {MicronGeometry} value
-     */
-    deserialize(buffer, value) {
-        // read spec
-        const attribute_count = buffer.readUintVar();
-        const attributes = [];
-        for (let i = 0; i < attribute_count; i++) {
-            const spec = new AttributeSpec();
-
-            deserialize_attribute_spec(buffer, spec);
-            attributes[i] = spec;
-        }
-
-        const vertex_spec = value.vertex_spec;
-        vertex_spec.setAttributes(attributes);
-
-        // read patches
-        const root_patch_index = buffer.readUintVar();
-
-        const patch_count = buffer.readUintVar();
-
-        /**
-         *
-         * @type {MicronGeometryPatch[]}
-         */
-        const patches = [];
-
-        // for the sake of speed, we will allocate all metadata in the same piece of memory to make traversal of patch hierarchy faster
-        const md_buffer = new ArrayBuffer(patch_count * 144);
-        let md_buffer_offset = 0;
-
-        // build initial patches
-        for (let i = 0; i < patch_count; i++) {
-            const patch = new MicronGeometryPatch();
-
-            patch.id = i;
-
-            md_buffer_offset += patch.allocate_metadata(md_buffer, md_buffer_offset);
-
-            patches[i] = patch;
-        }
-
-        let source_triangle_count = 0;
-        // NOTE: we can't easily find out source vertex count as vertices are duplicated across patches
-
-
-        //read patches
-        for (let i = 0; i < patch_count; i++) {
-            const patch = patches[i];
-
-            deserialize_patch(buffer, patch, vertex_spec, patches);
-
-            // collect source metadata
-            if (patch.lod === 0) {
-                source_triangle_count += patch.polygon_count;
-            }
-        }
-
-        value.patches = patches;
-        value.root = patches[root_patch_index];
-
-        // write source metadata
-        value.source_triangle_count = source_triangle_count;
-    }
-}

package/src/engine/graphics/micron/format/serialization/MicronGeometryBinarySerializationAdapter.spec.js

@@ -1,63 +0,0 @@
-import { MicronGeometryPatch } from "../MicronGeometryPatch.js";
-import { BinaryBuffer } from "../../../../../core/binary/BinaryBuffer.js";
-import { MicronGeometry } from "../MicronGeometry.js";
-import { VertexDataSpec } from "../../../geometry/VertexDataSpec.js";
-import { AttributeSpec } from "../../../geometry/AttributeSpec.js";
-import { BinaryDataType } from "../../../../../core/binary/type/BinaryDataType.js";
-import { MicronGeometryBinarySerializationAdapter } from "./MicronGeometryBinarySerializationAdapter.js";
-
-function sampleGeometry() {
-    const a = new MicronGeometryPatch();
-
-    a.vertex_attribute_arrays[0] = new Uint8Array([
-        7, 11, 13,
-        17, 23, 29,
-        31, 39, 43
-    ]);
-    a.vertex_count = 3;
-
-    a.face_indices = new Uint8Array([1, 2, 3]);
-    a.polygon_count = 1;
-
-    a.group_error = 1.234;
-
-    a.bounding_box.set([7, 11, 13, 31, 39, 43]);
-    a.group_bounding_box.set([7, 11, 13, 31, 39, 43]);
-    a.bounding_sphere.set([19, 25, 28, 50.1]);
-    a.group_bounding_sphere.set([19, 25, 28, 50.1]);
-
-    const g_a = new MicronGeometry();
-
-    const vertex_spec = new VertexDataSpec();
-    vertex_spec.add(AttributeSpec.fromJSON({
-        name: 'position',
-        type: BinaryDataType.Uint8,
-        itemSize: 3,
-        normalized: false
-    }));
-
-    g_a.vertex_spec = vertex_spec;
-    g_a.root = a;
-    g_a.initialize();
-
-    return g_a;
-}
-
-test("serialization/deserialization consistency", () => {
-    const g_a = sampleGeometry();
-
-    const buffer = new BinaryBuffer();
-
-    const adapter = new MicronGeometryBinarySerializationAdapter();
-
-    adapter.serialize(buffer, g_a);
-
-
-    const g_b = new MicronGeometry();
-
-    buffer.position = 0;
-    adapter.deserialize(buffer, g_b);
-
-    expect(g_b.vertex_spec.equals(g_a.vertex_spec)).toBe(true);
-    expect(g_b.patches.length).toEqual(g_a.patches.length);
-});

package/src/engine/graphics/micron/format/serialization/collection/geometry_collection_serialization.js

@@ -1,83 +0,0 @@
-import { MicronGeometryBinarySerializationAdapter } from "../MicronGeometryBinarySerializationAdapter.js";
-import { MicronGeometry } from "../../MicronGeometry.js";
-
-const SUPPORTED_ADAPTER_VERSION = 0;
-const HEADER_MAGIC_TEXT = 'MICRON#001';
-
-function obtain_micron_adapter() {
-
-    const ga = new MicronGeometryBinarySerializationAdapter();
-
-    if (ga.version !== SUPPORTED_ADAPTER_VERSION) {
-        throw new Error(`Incorrect version of serialization adapter, expected ${SUPPORTED_ADAPTER_VERSION}, instead got ${ga.version}`);
-    }
-
-    return ga;
-}
-
-/**
- *
- * @param {MicronGeometry[]} destination
- * @param {BinaryBuffer} buffer
- * @returns {number} how many geometries were read
- */
-export function deserialize_geometry_collection(destination, buffer) {
-    // read header
-    const header_text = buffer.readASCIICharacters(HEADER_MAGIC_TEXT.length);
-
-    if (header_text !== HEADER_MAGIC_TEXT) {
-        throw new Error(`Wrong header magic, expected '${HEADER_MAGIC_TEXT}', instead got '${header_text}'`);
-    }
-
-    // read how many geometries we're expecting
-    const geometry_occupies_count = buffer.readUint32();
-
-    const ga = obtain_micron_adapter();
-
-    for (let i = 0; i < geometry_occupies_count; i++) {
-        // read key
-        const key = buffer.readUint32();
-
-        const geometry = new MicronGeometry();
-
-        ga.deserialize(buffer, geometry);
-
-        destination[key] = geometry;
-    }
-
-    return geometry_occupies_count;
-}
-
-/**
- *
- * @param {MicronGeometry[]} geometries
- * @param {BinaryBuffer} buffer
- */
-export function serialize_geometry_collection(geometries, buffer) {
-    // write header
-    buffer.writeASCIIString(HEADER_MAGIC_TEXT); // magic bytes
-
-    // count geometries
-    let geometry_occupied_count = 0;
-    const geometry_count = geometries.length;
-    for (let i = 0; i < geometry_count; i++) {
-        if (geometries[i] !== undefined) {
-            geometry_occupied_count++;
-        }
-    }
-
-    buffer.writeUint32(geometry_occupied_count); // how many geometries to expect
-
-    const ga = obtain_micron_adapter();
-
-    for (let i = 0; i < geometry_count; i++) {
-        const geometry = geometries[i];
-        if (geometry === undefined) {
-            continue;
-        }
-
-        buffer.writeUint32(i); // key
-
-        ga.serialize(buffer, geometry);
-    }
-}

package/src/engine/graphics/micron/format/serialization/collection/geometry_collection_serialization.spec.js

@@ -1,51 +0,0 @@
-import { deserialize_geometry_collection, serialize_geometry_collection } from "./geometry_collection_serialization.js";
-import { BinaryBuffer } from "../../../../../../core/binary/BinaryBuffer.js";
-import { MicronGeometry } from "../../MicronGeometry.js";
-import { MicronGeometryPatch } from "../../MicronGeometryPatch.js";
-
-function sample_geo() {
-
-    const geometry = new MicronGeometry();
-
-    geometry.root = new MicronGeometryPatch();
-    geometry.patches.push(geometry.root);
-
-    return geometry;
-}
-
-test('serialize empty', () => {
-    const bb = new BinaryBuffer();
-
-    expect(() => {
-        serialize_geometry_collection([], bb);
-    }).not.toThrow();
-
-});
-
-test('serialize/deserialize empty', () => {
-    const bb = new BinaryBuffer();
-
-    serialize_geometry_collection([], bb);
-
-    bb.position = 0;
-
-    const destination = [];
-    deserialize_geometry_collection(destination, bb);
-
-    expect(destination.length).toBe(0);
-});
-
-test('serialize/deserialize 1', () => {
-    const bb = new BinaryBuffer();
-
-    const geometry = sample_geo();
-
-    serialize_geometry_collection([geometry], bb);
-
-    bb.position = 0;
-
-    const destination = [];
-    deserialize_geometry_collection(destination, bb);
-
-    expect(destination.length).toBe(1);
-});

package/src/engine/graphics/micron/format/serialization/deserialize_attribute_spec.js

@@ -1,25 +0,0 @@
-import { computeDataTypeByIndex } from "../../../../../core/binary/type/computeDataTypeByIndex.js";
-
-/**
- *
- * @param {BinaryBuffer} buffer
- * @param {AttributeSpec} spec
- */
-export function deserialize_attribute_spec(buffer, spec) {
-
-    spec.name = buffer.readUTF8String();
-    spec.itemSize = buffer.readUintVar();
-
-    const type_index = buffer.readUint8();
-    const type = computeDataTypeByIndex(type_index);
-
-    if (type === undefined) {
-        throw new Error(`Unknown data type marker '${type_index}'`);
-    }
-
-    spec.type = type;
-
-    const flags = buffer.readUint8();
-
-    spec.normalized = (flags & 0x1) !== 0;
-}

package/src/engine/graphics/micron/format/serialization/deserialize_patch.js

@@ -1,106 +0,0 @@
-import { aabb3_build_corners } from "../../../../../core/geom/3d/aabb/aabb3_build_corners.js";
-import { DataTypeByteSizes } from "../../../../../core/binary/type/DataTypeByteSizes.js";
-import {
-    DataType2TypedArrayConstructorMapping
-} from "../../../../../core/binary/type/DataType2TypedArrayConstructorMapping.js";
-
-/**
- *
- * @param {BinaryBuffer} buffer
- * @param {MicronGeometryPatch} patch
- * @param {VertexDataSpec} vertex_spec
- * @param {MicronGeometryPatch[]} patch_array
- */
-export function deserialize_patch(buffer, patch, vertex_spec, patch_array) {
-    // METADATA
-    buffer.readFloat32Array(patch.bounding_box, 0, 6);
-    buffer.readFloat32Array(patch.bounding_sphere, 0, 4);
-
-    const gbb = patch.group_bounding_box;
-    buffer.readFloat32Array(gbb, 0, 6);
-    buffer.readFloat32Array(patch.group_bounding_sphere, 0, 4);
-
-    patch.group_error = buffer.readFloat32();
-    patch.lod = buffer.readUintVar();
-    patch.polygon_count = buffer.readUintVar();
-    patch.vertex_count = buffer.readUintVar();
-
-    // parents
-    const parents = [];
-    const parent_count = buffer.readUintVar();
-
-    for (let i = 0; i < parent_count; i++) {
-        const parent_index = buffer.readUintVar();
-
-        if (patch_array.length <= parent_index || parent_index < 0) {
-            throw new Error(`out of bounds parent index '${parent_index}'`);
-        }
-
-        parents[i] = patch_array[parent_index];
-    }
-
-    patch.parents = parents;
-
-    // children
-    const children = [];
-    const child_count = buffer.readUintVar();
-
-    for (let i = 0; i < child_count; i++) {
-        const child_index = buffer.readUintVar();
-
-        if (patch_array.length <= child_index || child_index < 0) {
-            throw new Error(`out of bounds child index '${child_index}'`);
-        }
-
-        children[i] = patch_array[child_index];
-    }
-
-    patch.children = children;
-
-    // INDICES
-    const index_count = patch.polygon_count * 3;
-
-    if (patch.vertex_count <= 256) {
-        patch.face_indices = new Uint8Array(index_count);
-        buffer.readUint8Array(patch.face_indices, 0, index_count);
-    } else if (patch.vertex_count <= 65536) {
-        patch.face_indices = new Uint16Array(index_count);
-        buffer.readUint16Array(patch.face_indices, 0, index_count);
-    } else {
-        throw new Error(`Unsupported vertex count '${patch.vertex_count}'`);
-    }
-
-    // VERTICES
-    const attributes = vertex_spec.attributes;
-    const attribute_count = attributes.length;
-
-    for (let i = 0; i < attribute_count; i++) {
-        const spec = attributes[i];
-
-        const data_type = spec.type;
-        const item_size = spec.itemSize;
-
-        const byte_size = DataTypeByteSizes[data_type];
-
-        const ArrayConstructor = DataType2TypedArrayConstructorMapping[data_type];
-
-        const elment_count = item_size * patch.vertex_count;
-        const array = new ArrayConstructor(elment_count);
-
-        buffer.readUint8Array(new Uint8Array(array.buffer), 0, byte_size * elment_count);
-
-        patch.vertex_attribute_arrays[i] = array;
-    }
-
-    // reconstruct corners
-    aabb3_build_corners(
-        patch.group_bounding_box_corners,
-        0,
-        gbb[0],
-        gbb[1],
-        gbb[2],
-        gbb[3],
-        gbb[4],
-        gbb[5]
-    );
-}

package/src/engine/graphics/micron/format/serialization/serialize_attribute_spec.js

@@ -1,18 +0,0 @@
-import { DataTypeIndices } from "../../../../../core/binary/type/DataTypeIndices.js";
-
-/**
- *
- * @param {BinaryBuffer} buffer
- * @param {AttributeSpec} spec
- */
-export function serialize_attribute_spec(buffer, spec) {
-    buffer.writeUTF8String(spec.name);
-    buffer.writeUintVar(spec.itemSize);
-
-    const dataTypeIndex = DataTypeIndices[spec.type];
-    buffer.writeUint8(dataTypeIndex);
-
-    const flags = spec.normalized ? 1 : 0;
-
-    buffer.writeUint8(flags);// flags
-}

package/src/engine/graphics/micron/format/serialization/serialize_patch.js

@@ -1,84 +0,0 @@
-import { DataTypeByteSizes } from "../../../../../core/binary/type/DataTypeByteSizes.js";
-
-/**
- *
- * @param {BinaryBuffer} buffer
- * @param {MicronGeometryPatch} patch
- * @param {VertexDataSpec} vertex_spec
- * @param {MicronGeometryPatch[]} patch_array
- */
-export function serialize_patch(buffer, patch, vertex_spec, patch_array) {
-    // METADATA
-    buffer.writeFloat32Array(patch.bounding_box, 0, 6);
-    buffer.writeFloat32Array(patch.bounding_sphere, 0, 4);
-
-    buffer.writeFloat32Array(patch.group_bounding_box, 0, 6);
-    buffer.writeFloat32Array(patch.group_bounding_sphere, 0, 4);
-
-    buffer.writeFloat32(patch.group_error);
-    buffer.writeUintVar(patch.lod);
-    buffer.writeUintVar(patch.polygon_count);
-    buffer.writeUintVar(patch.vertex_count);
-
-    // write parents
-    const parents = patch.parents;
-    const parent_count = parents.length;
-
-    buffer.writeUintVar(parent_count);
-
-    for (let i = 0; i < parent_count; i++) {
-        const parent = parents[i];
-
-        const parent_index = patch_array.indexOf(parent);
-
-        if (parent_index === -1) {
-            throw new Error(`Patch '${parent.id}' not found in the lookup table`);
-        }
-
-        buffer.writeUintVar(parent_index);
-    }
-
-    // write children
-    const children = patch.children;
-    const child_count = children.length;
-
-    buffer.writeUintVar(child_count);
-
-    for (let i = 0; i < child_count; i++) {
-        const child = children[i];
-
-        const child_index = patch_array.indexOf(child);
-
-        if (child_index === -1) {
-            throw new Error(`Patch '${child.id}' not found in the lookup table`);
-        }
-
-        buffer.writeUintVar(child_index);
-    }
-
-    // INDICES
-    if (patch.vertex_count <= 256) {
-        buffer.writeUint8Array(patch.face_indices, 0, patch.polygon_count * 3);
-    } else if (patch.vertex_count <= 65536) {
-        buffer.writeUint16Array(patch.face_indices, 0, patch.polygon_count * 3);
-    } else {
-        throw new Error(`Unsupported vertex count '${patch.vertex_count}'`);
-    }
-
-    // VERTICES
-    const attributes = vertex_spec.attributes;
-    const attribute_count = attributes.length;
-
-    for (let i = 0; i < attribute_count; i++) {
-        const spec = attributes[i];
-
-        const data_type = spec.type;
-        const item_size = spec.itemSize;
-
-        const byte_size = DataTypeByteSizes[data_type];
-
-        const attribute_values = patch.vertex_attribute_arrays[i];
-
-        buffer.writeUint8Array(new Uint8Array(attribute_values.buffer), 0, item_size * byte_size * patch.vertex_count);
-    }
-}

package/src/engine/graphics/micron/format/validate_patch_bounds.js

@@ -1,69 +0,0 @@
-import { noop } from "../../../../core/function/Functions.js";
-import { aabb3_array_contains_point } from "../../../../core/geom/3d/aabb/aabb3_array_contains_point.js";
-import { sphere_array_intersects_point } from "../../../../core/geom/3d/sphere/sphere_array_intersects_point.js";
-
-/**
- *
- * @param {MicronGeometryPatch} patch
- * @param {VertexDataSpec} vertex_spec
- * @param {function(string)} [error_consumer]
- * @returns {boolean}
- */
-export function validate_patch_bounds(patch, vertex_spec, error_consumer = noop) {
-    const position_attribute_index = vertex_spec.getAttributeIndexByName('position');
-
-    if (position_attribute_index === -1) {
-        error_consumer(`No 'position' attribute found`);
-        // technically any bounds are valid if there is no position
-        return true;
-    }
-
-    const position_data = patch.vertex_attribute_arrays[position_attribute_index];
-
-    let b_sphere_valid = true;
-    let b_box_valid = true;
-    let gb_sphere_valid = true;
-    let gb_box_valid = true;
-
-    for (let i = 0; i < this.vertex_count; i++) {
-        const i3 = i * 3;
-
-        const x = position_data[i3];
-        const y = position_data[i3 + 1];
-        const z = position_data[i3 + 2];
-
-        if (!aabb3_array_contains_point(patch.bounding_box, x, y, z)) {
-            b_box_valid = false;
-        }
-
-        if (!aabb3_array_contains_point(patch.group_bounding_box, x, y, z)) {
-            gb_box_valid = false;
-        }
-
-        if (!sphere_array_intersects_point(patch.bounding_sphere, x, y, z)) {
-            b_sphere_valid = false;
-        }
-
-        if (!sphere_array_intersects_point(patch.group_bounding_sphere, x, y, z)) {
-            gb_sphere_valid = false;
-        }
-    }
-
-    if (!b_sphere_valid) {
-        error_consumer('.bounding_sphere is violated');
-    }
-
-    if (!gb_sphere_valid) {
-        error_consumer('.group_bounding_sphere is violated');
-    }
-
-    if (!b_box_valid) {
-        error_consumer('.bounding_box is violated');
-    }
-
-    if (!gb_box_valid) {
-        error_consumer('.group_bounding_box is violated');
-    }
-
-    return b_sphere_valid && gb_sphere_valid && b_box_valid && gb_box_valid;
-}