@woosh/meep-engine 3.42.0 → 3.44.0

package/src/shade/renderer/atmosphere/GPUSky.js

@@ -1,148 +1,163 @@
-import { FrameGraph } from "../../../engine/graphics/render/frame_graph/FrameGraph.js";
-import { TextureResourceDescriptor } from "../../device/graph/TextureResourceDescriptor.js";
-import { ShadeGPUCommandContext } from "../../device/ShadeGPUCommandContext.js";
-import { graph_compute_pass } from "../shader/graph/compute/graph_compute_pass.js";
-import { graph_image_pass } from "../shader/graph/graph_image_pass.js";
-import { debug_draw_texture } from "../texture/debug_draw_texture.js";
-import { GPUTextureContext } from "../texture/GPUTextureContext.js";
-import { shader_multiscatter_lut } from "./shader_multiscatter_lut.js";
-import { shader_transmittance_lut } from "./shader_transmittance_lut.js";
-
-export class GPUSky {
-
-    /**
-     * @type {GraphicsContext}
-     */
-    #graphics;
-
-    /**
-     * @type {GPUTextureContext}
-     */
-    #lut_transmittance;
-
-    /**
-     *
-     * @returns {GPUTextureContext}
-     */
-    get lut_transmittance() {
-        return this.#lut_transmittance;
-    }
-
-    /**
-     * @type {GPUTextureContext}
-     */
-    #lut_multiple_scattering;
-
-    /**
-     *
-     * @returns {GPUTextureContext}
-     */
-    get lut_multiple_scattering() {
-        return this.#lut_multiple_scattering;
-    }
-
-    /**
-     *
-     * @type {boolean}
-     */
-    #needs_update = true;
-
-    /**
-     *
-     * @param {GraphicsContext} graphics
-     */
-    constructor(graphics) {
-        this.#graphics = graphics;
-
-        const device = graphics.device;
-
-        this.#lut_transmittance = new GPUTextureContext(device);
-        this.#lut_transmittance.descriptor.label = "Sky / Transmittance LUT";
-        this.#lut_transmittance.descriptor.format = "rgba16float";
-        this.#lut_transmittance.descriptor.usage = GPUTextureUsage.RENDER_ATTACHMENT | GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.COPY_SRC;
-        this.#lut_transmittance.resize(256, 64);
-
-        this.#lut_multiple_scattering = new GPUTextureContext(device);
-        this.#lut_multiple_scattering.descriptor.label = "Sky / Multiple Scattering LUT";
-        this.#lut_multiple_scattering.descriptor.format = "rgba16float";
-        // written by a compute shader, so STORAGE_BINDING rather than RENDER_ATTACHMENT
-        this.#lut_multiple_scattering.descriptor.usage = GPUTextureUsage.STORAGE_BINDING | GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.COPY_SRC;
-        this.#lut_multiple_scattering.resize(32, 32);
-
-
-    }
-
-    destroy() {
-        this.#lut_transmittance.destroy();
-        this.#lut_multiple_scattering.destroy();
-    }
-
-    debug() {
-
-
-        let y = 50;
-        debug_draw_texture({ texture: this.#lut_transmittance, x: 50, y: y });
-
-        y += this.#lut_transmittance.size[1] + 50;
-
-        debug_draw_texture({ texture: this.#lut_multiple_scattering, x: 50, y: y });
-
-        y += this.#lut_multiple_scattering.size[1] + 50;
-
-    }
-
-    /**
-     *
-     */
-    update() {
-        if (!this.#needs_update) {
-            return;
-        }
-
-        const graph = new FrameGraph("sky update");
-
-        const command_ctx = ShadeGPUCommandContext.create(
-            this.#graphics,
-            "Renderer/main"
-        );
-
-        const gr_transmittance = graph.import_resource("transmittance", TextureResourceDescriptor.fromTexture(this.#lut_transmittance.gpu_texture), this.#lut_transmittance);
-        const gr_multiscatter = graph.import_resource("multiscatter", TextureResourceDescriptor.fromTexture(this.#lut_multiple_scattering.gpu_texture), this.#lut_multiple_scattering);
-
-        // the handle the write produced, not the one imported: binding the pre-write version below
-        // is a superseded read, which is exactly what `validate()` rejects
-        const [gr_transmittance_written] = graph_image_pass({
-            graph,
-            shader: shader_transmittance_lut,
-            inputs: {
-                settings: {
-                    steps: 40,
-                    // read off the texture rather than restated, so the two cannot disagree
-                    resolution: [this.#lut_transmittance.width, this.#lut_transmittance.height],
-                }
-            },
-            output: [gr_transmittance]
-        });
-
-
-        graph_compute_pass({
-            graph,
-            shader: shader_multiscatter_lut,
-            // one workgroup per LUT texel, counted off the texture being written so the
-            // dispatch cannot cover a different area than the shader stores into
-            group_count: [this.#lut_multiple_scattering.width, this.#lut_multiple_scattering.height, 1],
-            bindings: {
-                tSkyLutTransmittance: gr_transmittance_written,
-                tSkyLutMultiscatterOut: gr_multiscatter
-            }
-        });
-
-        command_ctx.encodeGraph(graph);
-
-        command_ctx.finish();
-
-
-        this.#needs_update = false;
-    }
-
+import { FrameGraph } from "../../../engine/graphics/render/frame_graph/FrameGraph.js";
+import { TextureResourceDescriptor } from "../../device/graph/TextureResourceDescriptor.js";
+import { ShadeGPUCommandContext } from "../../device/ShadeGPUCommandContext.js";
+import { graph_compute_pass } from "../shader/graph/compute/graph_compute_pass.js";
+import { graph_image_pass } from "../shader/graph/graph_image_pass.js";
+import { debug_draw_texture } from "../texture/debug_draw_texture.js";
+import { GPUTextureContext } from "../texture/GPUTextureContext.js";
+import { shader_multiscatter_lut } from "./shader_multiscatter_lut.js";
+import { shader_transmittance_lut } from "./shader_transmittance_lut.js";
+
+/**
+ * @typedef {import("../GraphicsContext.js").GraphicsContext} GraphicsContext
+ */
+
+export class GPUSky {
+
+    /**
+     * @type {GraphicsContext}
+     */
+    #graphics;
+
+    /**
+     * @type {GPUTextureContext}
+     */
+    #lut_transmittance;
+
+    /**
+     *
+     * @returns {GPUTextureContext}
+     */
+    get lut_transmittance() {
+        return this.#lut_transmittance;
+    }
+
+    /**
+     * @type {GPUTextureContext}
+     */
+    #lut_multiple_scattering;
+
+    /**
+     *
+     * @returns {GPUTextureContext}
+     */
+    get lut_multiple_scattering() {
+        return this.#lut_multiple_scattering;
+    }
+
+    /**
+     *
+     * @type {boolean}
+     */
+    #needs_update = true;
+
+    /**
+     * Whether the LUTs still hold nothing a reader could use: true until the first {@link update}.
+     * What reads {@link lut_transmittance} or {@link lut_multiple_scattering} has to see this false,
+     * as a texture nobody wrote reads as zero rather than failing.
+     *
+     * @returns {boolean}
+     */
+    get needs_update() {
+        return this.#needs_update;
+    }
+
+    /**
+     *
+     * @param {GraphicsContext} graphics
+     */
+    constructor(graphics) {
+        this.#graphics = graphics;
+
+        const device = graphics.device;
+
+        this.#lut_transmittance = new GPUTextureContext(device);
+        this.#lut_transmittance.descriptor.label = "Sky / Transmittance LUT";
+        this.#lut_transmittance.descriptor.format = "rgba16float";
+        this.#lut_transmittance.descriptor.usage = GPUTextureUsage.RENDER_ATTACHMENT | GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.COPY_SRC;
+        this.#lut_transmittance.resize(256, 64);
+
+        this.#lut_multiple_scattering = new GPUTextureContext(device);
+        this.#lut_multiple_scattering.descriptor.label = "Sky / Multiple Scattering LUT";
+        this.#lut_multiple_scattering.descriptor.format = "rgba16float";
+        // written by a compute shader, so STORAGE_BINDING rather than RENDER_ATTACHMENT
+        this.#lut_multiple_scattering.descriptor.usage = GPUTextureUsage.STORAGE_BINDING | GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.COPY_SRC;
+        this.#lut_multiple_scattering.resize(32, 32);
+
+
+    }
+
+    destroy() {
+        this.#lut_transmittance.destroy();
+        this.#lut_multiple_scattering.destroy();
+    }
+
+    debug() {
+
+
+        let y = 50;
+        debug_draw_texture({ texture: this.#lut_transmittance, x: 50, y: y });
+
+        y += this.#lut_transmittance.size[1] + 50;
+
+        debug_draw_texture({ texture: this.#lut_multiple_scattering, x: 50, y: y });
+
+        y += this.#lut_multiple_scattering.size[1] + 50;
+
+    }
+
+    /**
+     *
+     */
+    update() {
+        if (!this.#needs_update) {
+            return;
+        }
+
+        const graph = new FrameGraph("sky update");
+
+        const command_ctx = ShadeGPUCommandContext.create(
+            this.#graphics,
+            "Renderer/main"
+        );
+
+        const gr_transmittance = graph.import_resource("transmittance", TextureResourceDescriptor.fromTexture(this.#lut_transmittance.gpu_texture), this.#lut_transmittance);
+        const gr_multiscatter = graph.import_resource("multiscatter", TextureResourceDescriptor.fromTexture(this.#lut_multiple_scattering.gpu_texture), this.#lut_multiple_scattering);
+
+        // the handle the write produced, not the one imported: binding the pre-write version below
+        // is a superseded read, which is exactly what `validate()` rejects
+        const [gr_transmittance_written] = graph_image_pass({
+            graph,
+            shader: shader_transmittance_lut,
+            inputs: {
+                settings: {
+                    steps: 40,
+                    // read off the texture rather than restated, so the two cannot disagree
+                    resolution: [this.#lut_transmittance.width, this.#lut_transmittance.height],
+                }
+            },
+            output: [gr_transmittance]
+        });
+
+
+        graph_compute_pass({
+            graph,
+            shader: shader_multiscatter_lut,
+            // one workgroup per LUT texel, counted off the texture being written so the
+            // dispatch cannot cover a different area than the shader stores into
+            group_count: [this.#lut_multiple_scattering.width, this.#lut_multiple_scattering.height, 1],
+            bindings: {
+                tSkyLutTransmittance: gr_transmittance_written,
+                tSkyLutMultiscatterOut: gr_multiscatter
+            }
+        });
+
+        command_ctx.encodeGraph(graph);
+
+        command_ctx.finish();
+
+
+        this.#needs_update = false;
+    }
+
 }

package/src/shade/renderer/geometry/BoxGeometry.d.ts

@@ -11,16 +11,6 @@ export class BoxGeometry extends MeshletGeometry {
      */
     constructor(width?: number, height?: number, depth?: number);
 }
-/**
- */
-export class PlaneGeometry extends MeshletGeometry {
-    /**
-     * @param {number} [width]
-     * @param {number} [height]
-     * @param {number} [widthSegments]
-     * @param {number} [heightSegments]
-     */
-    constructor(width?: number, height?: number, widthSegments?: number, heightSegments?: number);
-}
+export { PlaneGeometry } from "./PlaneGeometry.js";
 import { MeshletGeometry } from "./MeshletGeometry.js";
 //# sourceMappingURL=BoxGeometry.d.ts.map

package/src/shade/renderer/geometry/BoxGeometry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BoxGeometry.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/geometry/BoxGeometry.js"],"names":[],"mappings":"AAKA;;;;GAIG;AACH;IACI;;;;OAIG;IACH,oBAJW,MAAM,WACN,MAAM,UACN,MAAM,EAKhB;CACJ;AAED;GACG;AACH;IACI;;;;;OAKG;IACH,oBALW,MAAM,WACN,MAAM,kBACN,MAAM,mBACN,MAAM,EAKhB;CACJ;gCAlC+B,sBAAsB"}
+{"version":3,"file":"BoxGeometry.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/geometry/BoxGeometry.js"],"names":[],"mappings":"AAIA;;;;GAIG;AACH;IACI;;;;OAIG;IACH,oBAJW,MAAM,WACN,MAAM,UACN,MAAM,EAKhB;CACJ;;gCAlB+B,sBAAsB"}

package/src/shade/renderer/geometry/BoxGeometry.js

@@ -1,7 +1,6 @@
 import { meshlet_geometry_build_from_geometry } from "./meshlet_geometry_build_from_geometry.js";
 import { MeshletGeometry } from "./MeshletGeometry.js";
 import { make_box_geometry } from "./primitives/make_box_geometry.js";
-import { make_plane_geometry } from "./primitives/make_plane_geometry.js";
 
 /**
  * Axis-aligned box, ready to render. Constructs a regular triangulated
@@ -20,17 +19,11 @@ export class BoxGeometry extends MeshletGeometry {
     }
 }
 
-/**
- */
-export class PlaneGeometry extends MeshletGeometry {
+export {
+    // The tag goes on the specifier, inside the braces: on the statement, TypeScript never sees it.
     /**
-     * @param {number} [width]
-     * @param {number} [height]
-     * @param {number} [widthSegments]
-     * @param {number} [heightSegments]
+     * @deprecated `PlaneGeometry` moved to its own module, one class per file like every other
+     * primitive. Import {@link PlaneGeometry} from "./PlaneGeometry.js" instead.
      */
-    constructor(width = 1, height = 1, widthSegments = 1, heightSegments = 1) {
-        super();
-        meshlet_geometry_build_from_geometry(make_plane_geometry(width, height, widthSegments, heightSegments), this);
-    }
-}
+    PlaneGeometry
+} from "./PlaneGeometry.js";

package/src/shade/renderer/geometry/CapsuleGeometry.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Capsule along the Y axis, ready to render: the same shape a `CapsuleShape3D` of the same radius
+ * and height describes. Constructs a regular triangulated `Geometry` and immediately converts it to
+ * the meshlet representation the renderer consumes.
+ *
+ * @see make_capsule_geometry
+ */
+export class CapsuleGeometry extends MeshletGeometry {
+    /**
+     * @param {number} [radius]
+     * @param {number} [height] length of the straight section, not counting the caps
+     * @param {number} [capSegments] segments from each pole to the equator
+     * @param {number} [radialSegments] segments around the axis
+     * @param {number} [heightSegments] segments along the straight section
+     */
+    constructor(radius?: number, height?: number, capSegments?: number, radialSegments?: number, heightSegments?: number);
+}
+import { MeshletGeometry } from "./MeshletGeometry.js";
+//# sourceMappingURL=CapsuleGeometry.d.ts.map

package/src/shade/renderer/geometry/CapsuleGeometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CapsuleGeometry.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/geometry/CapsuleGeometry.js"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH;IACI;;;;;;OAMG;IACH,qBANW,MAAM,WACN,MAAM,gBACN,MAAM,mBACN,MAAM,mBACN,MAAM,EAKhB;CACJ;gCAtB+B,sBAAsB"}

package/src/shade/renderer/geometry/CapsuleGeometry.js

@@ -0,0 +1,24 @@
+import { meshlet_geometry_build_from_geometry } from "./meshlet_geometry_build_from_geometry.js";
+import { MeshletGeometry } from "./MeshletGeometry.js";
+import { make_capsule_geometry } from "./primitives/make_capsule_geometry.js";
+
+/**
+ * Capsule along the Y axis, ready to render: the same shape a `CapsuleShape3D` of the same radius
+ * and height describes. Constructs a regular triangulated `Geometry` and immediately converts it to
+ * the meshlet representation the renderer consumes.
+ *
+ * @see make_capsule_geometry
+ */
+export class CapsuleGeometry extends MeshletGeometry {
+    /**
+     * @param {number} [radius]
+     * @param {number} [height] length of the straight section, not counting the caps
+     * @param {number} [capSegments] segments from each pole to the equator
+     * @param {number} [radialSegments] segments around the axis
+     * @param {number} [heightSegments] segments along the straight section
+     */
+    constructor(radius = 1, height = 1, capSegments = 4, radialSegments = 8, heightSegments = 1) {
+        super();
+        meshlet_geometry_build_from_geometry(make_capsule_geometry(radius, height, capSegments, radialSegments, heightSegments), this);
+    }
+}

package/src/shade/renderer/geometry/ConeGeometry.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Cone along the Y axis with its apex at the top, ready to render. Constructs a regular triangulated
+ * `Geometry` and immediately converts it to the meshlet representation the renderer consumes.
+ *
+ * @see make_cone_geometry
+ */
+export class ConeGeometry extends MeshletGeometry {
+    /**
+     * @param {number} [radius] radius of the base
+     * @param {number} [height]
+     * @param {number} [radialSegments] segments around the axis
+     * @param {number} [heightSegments] segments along the axis
+     * @param {boolean} [openEnded] leave the base off
+     * @param {number} [thetaStart]
+     * @param {number} [thetaLength] how much of the turn to build, in radians
+     */
+    constructor(radius?: number, height?: number, radialSegments?: number, heightSegments?: number, openEnded?: boolean, thetaStart?: number, thetaLength?: number);
+}
+import { MeshletGeometry } from "./MeshletGeometry.js";
+//# sourceMappingURL=ConeGeometry.d.ts.map

package/src/shade/renderer/geometry/ConeGeometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConeGeometry.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/geometry/ConeGeometry.js"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH;IACI;;;;;;;;OAQG;IACH,qBARW,MAAM,WACN,MAAM,mBACN,MAAM,mBACN,MAAM,cACN,OAAO,eACP,MAAM,gBACN,MAAM,EAahB;CACJ;gCA/B+B,sBAAsB"}

package/src/shade/renderer/geometry/ConeGeometry.js

@@ -0,0 +1,33 @@
+import { meshlet_geometry_build_from_geometry } from "./meshlet_geometry_build_from_geometry.js";
+import { MeshletGeometry } from "./MeshletGeometry.js";
+import { make_cone_geometry } from "./primitives/make_cone_geometry.js";
+
+/**
+ * Cone along the Y axis with its apex at the top, ready to render. Constructs a regular triangulated
+ * `Geometry` and immediately converts it to the meshlet representation the renderer consumes.
+ *
+ * @see make_cone_geometry
+ */
+export class ConeGeometry extends MeshletGeometry {
+    /**
+     * @param {number} [radius] radius of the base
+     * @param {number} [height]
+     * @param {number} [radialSegments] segments around the axis
+     * @param {number} [heightSegments] segments along the axis
+     * @param {boolean} [openEnded] leave the base off
+     * @param {number} [thetaStart]
+     * @param {number} [thetaLength] how much of the turn to build, in radians
+     */
+    constructor(
+        radius = 1,
+        height = 1,
+        radialSegments = 8,
+        heightSegments = 1,
+        openEnded = false,
+        thetaStart = 0,
+        thetaLength = Math.PI * 2
+    ) {
+        super();
+        meshlet_geometry_build_from_geometry(make_cone_geometry(radius, height, radialSegments, heightSegments, openEnded, thetaStart, thetaLength), this);
+    }
+}

package/src/shade/renderer/geometry/CylinderGeometry.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Cylinder along the Y axis, ready to render. Constructs a regular triangulated `Geometry` and
+ * immediately converts it to the meshlet representation the renderer consumes.
+ *
+ * @see make_cylinder_geometry
+ */
+export class CylinderGeometry extends MeshletGeometry {
+    /**
+     * @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
+     * @param {number} [thetaStart]
+     * @param {number} [thetaLength] how much of the turn to build, in radians
+     */
+    constructor(radiusTop?: number, radiusBottom?: number, height?: number, radialSegments?: number, heightSegments?: number, openEnded?: boolean, thetaStart?: number, thetaLength?: number);
+}
+import { MeshletGeometry } from "./MeshletGeometry.js";
+//# sourceMappingURL=CylinderGeometry.d.ts.map

package/src/shade/renderer/geometry/CylinderGeometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CylinderGeometry.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/geometry/CylinderGeometry.js"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH;IACI;;;;;;;;;OASG;IACH,wBATW,MAAM,iBACN,MAAM,WACN,MAAM,mBACN,MAAM,mBACN,MAAM,cACN,OAAO,eACP,MAAM,gBACN,MAAM,EAchB;CACJ;gCAjC+B,sBAAsB"}

package/src/shade/renderer/geometry/CylinderGeometry.js

@@ -0,0 +1,35 @@
+import { meshlet_geometry_build_from_geometry } from "./meshlet_geometry_build_from_geometry.js";
+import { MeshletGeometry } from "./MeshletGeometry.js";
+import { make_cylinder_geometry } from "./primitives/make_cylinder_geometry.js";
+
+/**
+ * Cylinder along the Y axis, ready to render. Constructs a regular triangulated `Geometry` and
+ * immediately converts it to the meshlet representation the renderer consumes.
+ *
+ * @see make_cylinder_geometry
+ */
+export class CylinderGeometry extends MeshletGeometry {
+    /**
+     * @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
+     * @param {number} [thetaStart]
+     * @param {number} [thetaLength] how much of the turn to build, in radians
+     */
+    constructor(
+        radiusTop = 1,
+        radiusBottom = 1,
+        height = 1,
+        radialSegments = 8,
+        heightSegments = 1,
+        openEnded = false,
+        thetaStart = 0,
+        thetaLength = Math.PI * 2
+    ) {
+        super();
+        meshlet_geometry_build_from_geometry(make_cylinder_geometry(radiusTop, radiusBottom, height, radialSegments, heightSegments, openEnded, thetaStart, thetaLength), this);
+    }
+}

package/src/shade/renderer/geometry/PlaneGeometry.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Plane in the XY plane facing +Z, ready to render. Constructs a regular triangulated `Geometry`
+ * and immediately converts it to the meshlet representation the renderer consumes.
+ *
+ * @see make_plane_geometry
+ */
+export class PlaneGeometry extends MeshletGeometry {
+    /**
+     * @param {number} [width]
+     * @param {number} [height]
+     * @param {number} [widthSegments]
+     * @param {number} [heightSegments]
+     */
+    constructor(width?: number, height?: number, widthSegments?: number, heightSegments?: number);
+}
+import { MeshletGeometry } from "./MeshletGeometry.js";
+//# sourceMappingURL=PlaneGeometry.d.ts.map

package/src/shade/renderer/geometry/PlaneGeometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlaneGeometry.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/geometry/PlaneGeometry.js"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH;IACI;;;;;OAKG;IACH,oBALW,MAAM,WACN,MAAM,kBACN,MAAM,mBACN,MAAM,EAKhB;CACJ;gCApB+B,sBAAsB"}

package/src/shade/renderer/geometry/PlaneGeometry.js

@@ -0,0 +1,22 @@
+import { meshlet_geometry_build_from_geometry } from "./meshlet_geometry_build_from_geometry.js";
+import { MeshletGeometry } from "./MeshletGeometry.js";
+import { make_plane_geometry } from "./primitives/make_plane_geometry.js";
+
+/**
+ * Plane in the XY plane facing +Z, ready to render. Constructs a regular triangulated `Geometry`
+ * and immediately converts it to the meshlet representation the renderer consumes.
+ *
+ * @see make_plane_geometry
+ */
+export class PlaneGeometry extends MeshletGeometry {
+    /**
+     * @param {number} [width]
+     * @param {number} [height]
+     * @param {number} [widthSegments]
+     * @param {number} [heightSegments]
+     */
+    constructor(width = 1, height = 1, widthSegments = 1, heightSegments = 1) {
+        super();
+        meshlet_geometry_build_from_geometry(make_plane_geometry(width, height, widthSegments, heightSegments), this);
+    }
+}

package/src/shade/renderer/geometry/TorusGeometry.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Torus in the XY plane with its hole along Z, ready to render. Constructs a regular triangulated
+ * `Geometry` and immediately converts it to the meshlet representation the renderer consumes.
+ *
+ * @see make_torus_geometry
+ */
+export class TorusGeometry extends MeshletGeometry {
+    /**
+     * @param {number} [radius] distance from the centre of the hole to the centre of the tube
+     * @param {number} [tube] radius of the tube itself
+     * @param {number} [radialSegments] segments around the tube
+     * @param {number} [tubularSegments] segments around the ring
+     * @param {number} [arc] how much of the ring to build, in radians
+     */
+    constructor(radius?: number, tube?: number, radialSegments?: number, tubularSegments?: number, arc?: number);
+}
+import { MeshletGeometry } from "./MeshletGeometry.js";
+//# sourceMappingURL=TorusGeometry.d.ts.map

package/src/shade/renderer/geometry/TorusGeometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TorusGeometry.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/geometry/TorusGeometry.js"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH;IACI;;;;;;OAMG;IACH,qBANW,MAAM,SACN,MAAM,mBACN,MAAM,oBACN,MAAM,QACN,MAAM,EAKhB;CACJ;gCArB+B,sBAAsB"}

package/src/shade/renderer/geometry/TorusGeometry.js

@@ -0,0 +1,23 @@
+import { meshlet_geometry_build_from_geometry } from "./meshlet_geometry_build_from_geometry.js";
+import { MeshletGeometry } from "./MeshletGeometry.js";
+import { make_torus_geometry } from "./primitives/make_torus_geometry.js";
+
+/**
+ * Torus in the XY plane with its hole along Z, ready to render. Constructs a regular triangulated
+ * `Geometry` and immediately converts it to the meshlet representation the renderer consumes.
+ *
+ * @see make_torus_geometry
+ */
+export class TorusGeometry extends MeshletGeometry {
+    /**
+     * @param {number} [radius] distance from the centre of the hole to the centre of the tube
+     * @param {number} [tube] radius of the tube itself
+     * @param {number} [radialSegments] segments around the tube
+     * @param {number} [tubularSegments] segments around the ring
+     * @param {number} [arc] how much of the ring to build, in radians
+     */
+    constructor(radius = 1, tube = 0.4, radialSegments = 8, tubularSegments = 6, arc = Math.PI * 2) {
+        super();
+        meshlet_geometry_build_from_geometry(make_torus_geometry(radius, tube, radialSegments, tubularSegments, arc), this);
+    }
+}