@woosh/meep-engine 3.0.1 → 3.0.2

package/src/shade/renderer/geometry/primitives/make_cylinder_geometry.js

@@ -0,0 +1,240 @@
+import { Attribute } from "../Attribute.js";
+import { Geometry } from "../Geometry.js";
+import { StandardAttributes } from "../StandardAttributes.js";
+
+/**
+ * The axis runs along Y and the body is centred on the origin.
+ *
+ * `Geometry` carries no multi-material groups, so the torso and the two caps are one index run
+ * rather than three; three's cylinder splits them only to address a material array.
+ *
+ * @param {number} [radiusTop]
+ * @param {number} [radiusBottom]
+ * @param {number} [height]
+ * @param {number} [radialSegments] segments around the axis
+ * @param {number} [heightSegments] segments along the axis
+ * @param {boolean} [openEnded] leave the caps off, which makes the surface a tube rather than a solid
+ * @param {number} [thetaStart]
+ * @param {number} [thetaLength] how much of the turn to build, in radians
+ * @returns {Geometry}
+ */
+export function make_cylinder_geometry(
+    radiusTop = 1,
+    radiusBottom = 1,
+    height = 1,
+    radialSegments = 8,
+    heightSegments = 1,
+    openEnded = false,
+    thetaStart = 0,
+    thetaLength = Math.PI * 2
+) {
+
+    /*
+     A port of three's `CylinderGeometry` onto `Geometry`: the same parameterisation and the same
+     winding, writing meep attributes instead of three ones.
+
+     Derived from three.js (https://github.com/mrdoob/three.js), Copyright (c) 2010-2024 three.js authors, MIT licence.
+    */
+
+    const geo = new Geometry();
+
+    geo.name = "Cylinder";
+
+    // segments
+
+    radialSegments = Math.floor(radialSegments);
+    heightSegments = Math.floor(heightSegments);
+
+    // buffers
+
+    const indices = [];
+    const vertices = [];
+    const normals = [];
+    const uvs = [];
+
+    // helper variables
+
+    let index = 0;
+    const indexArray = [];
+    const halfHeight = height / 2;
+
+    // generate geometry
+
+    generateTorso();
+
+    if (openEnded === false) {
+
+        if (radiusTop > 0) {
+            generateCap(true);
+        }
+
+        if (radiusBottom > 0) {
+            generateCap(false);
+        }
+
+    }
+
+    // build geometry
+
+    geo.index = Attribute.from(new Uint32Array(indices), 1, 'index');
+    geo.addAttribute(Attribute.from(new Float32Array(vertices), 3, StandardAttributes.Position));
+    geo.addAttribute(Attribute.from(new Float32Array(normals), 3, StandardAttributes.Normal));
+    geo.addAttribute(Attribute.from(new Float32Array(uvs), 2, StandardAttributes.TextureCoordinates0));
+
+    function generateTorso() {
+
+        // this will be used to calculate the normal
+        const slope = (radiusBottom - radiusTop) / height;
+
+        // generate vertices, normals and uvs
+
+        for (let y = 0; y <= heightSegments; y++) {
+
+            const indexRow = [];
+
+            const v = y / heightSegments;
+
+            // calculate the radius of the current row
+
+            const radius = v * (radiusBottom - radiusTop) + radiusTop;
+
+            for (let x = 0; x <= radialSegments; x++) {
+
+                const u = x / radialSegments;
+
+                const theta = u * thetaLength + thetaStart;
+
+                const sinTheta = Math.sin(theta);
+                const cosTheta = Math.cos(theta);
+
+                // vertex
+
+                vertices.push(radius * sinTheta, -v * height + halfHeight, radius * cosTheta);
+
+                // normal
+
+                const normal_length = Math.sqrt(sinTheta * sinTheta + slope * slope + cosTheta * cosTheta);
+
+                normals.push(sinTheta / normal_length, slope / normal_length, cosTheta / normal_length);
+
+                // uv
+
+                uvs.push(u, 1 - v);
+
+                // save index of vertex in respective row
+
+                indexRow.push(index++);
+
+            }
+
+            // now save vertices of the row in our index array
+
+            indexArray.push(indexRow);
+
+        }
+
+        // generate indices
+
+        for (let x = 0; x < radialSegments; x++) {
+
+            for (let y = 0; y < heightSegments; y++) {
+
+                // we use the index array to access the correct indices
+
+                const a = indexArray[y][x];
+                const b = indexArray[y + 1][x];
+                const c = indexArray[y + 1][x + 1];
+                const d = indexArray[y][x + 1];
+
+                // faces
+
+                indices.push(a, b, d);
+                indices.push(b, c, d);
+
+            }
+
+        }
+
+    }
+
+    /**
+     * @param {boolean} top
+     */
+    function generateCap(top) {
+
+        // save the index of the first center vertex
+        const centerIndexStart = index;
+
+        const radius = top ? radiusTop : radiusBottom;
+        const sign = top ? 1 : -1;
+
+        // first we generate the center vertex data of the cap.
+        // because the geometry needs one set of uvs per face,
+        // we must generate a center vertex per face/segment
+
+        for (let x = 1; x <= radialSegments; x++) {
+
+            vertices.push(0, halfHeight * sign, 0);
+            normals.push(0, sign, 0);
+            uvs.push(0.5, 0.5);
+
+            index++;
+
+        }
+
+        // save the index of the last center vertex
+        const centerIndexEnd = index;
+
+        // now we generate the surrounding vertices, normals and uvs
+
+        for (let x = 0; x <= radialSegments; x++) {
+
+            const u = x / radialSegments;
+            const theta = u * thetaLength + thetaStart;
+
+            const cosTheta = Math.cos(theta);
+            const sinTheta = Math.sin(theta);
+
+            // vertex
+
+            vertices.push(radius * sinTheta, halfHeight * sign, radius * cosTheta);
+
+            // normal
+
+            normals.push(0, sign, 0);
+
+            // uv
+
+            uvs.push((cosTheta * 0.5) + 0.5, (sinTheta * 0.5 * sign) + 0.5);
+
+            index++;
+
+        }
+
+        // generate indices
+
+        for (let x = 0; x < radialSegments; x++) {
+
+            const c = centerIndexStart + x;
+            const i = centerIndexEnd + x;
+
+            if (top) {
+
+                // face top
+
+                indices.push(i, i + 1, c);
+
+            } else {
+
+                // face bottom
+
+                indices.push(i + 1, i, c);
+
+            }
+
+        }
+
+    }
+
+    return geo;
+}

package/src/shade/renderer/geometry/primitives/make_plane_geometry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"make_plane_geometry.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/geometry/primitives/make_plane_geometry.js"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,uHAFa,QAAQ,CAiIpB;yBA1IwB,gBAAgB"}
+{"version":3,"file":"make_plane_geometry.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/geometry/primitives/make_plane_geometry.js"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,uHAFa,QAAQ,CAsIpB;yBA/IwB,gBAAgB"}

package/src/shade/renderer/geometry/primitives/make_plane_geometry.js

@@ -12,7 +12,12 @@ import { StandardAttributes } from "../StandardAttributes.js";
  */
 export function make_plane_geometry(width = 1, height = 1, widthSegments = 1, heightSegments = 1) {
 
-    // based on three.js code
+    /*
+     A port of three's `PlaneGeometry` onto `Geometry`: the same subdivision and the same
+     winding, writing meep attributes instead of three ones.
+
+     Derived from three.js (https://github.com/mrdoob/three.js), Copyright (c) 2010-2024 three.js authors, MIT licence.
+    */
 
     const geo = new Geometry();
 

package/src/shade/renderer/geometry/primitives/make_polyhedron_geometry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"make_polyhedron_geometry.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/geometry/primitives/make_polyhedron_geometry.js"],"names":[],"mappings":"AAMA;;;;;;;GAOG;AACH,mDANW,MAAM,EAAE,WACR,MAAM,EAAE,WACR,MAAM,WACN,MAAM,GACJ,QAAQ,CAsTpB;yBA/TwB,gBAAgB"}
+{"version":3,"file":"make_polyhedron_geometry.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/geometry/primitives/make_polyhedron_geometry.js"],"names":[],"mappings":"AAMA;;;;;;;GAOG;AACH,mDANW,MAAM,EAAE,WACR,MAAM,EAAE,WACR,MAAM,WACN,MAAM,GACJ,QAAQ,CA2TpB;yBApUwB,gBAAgB"}