@woosh/meep-engine 3.67.0 → 3.69.0

package/src/engine/graphics/trail/tube/TubeX.d.ts

@@ -1,186 +0,0 @@
-/**
- * Dynamic, non-allocating 3D tube geometry — the volumetric analogue of
- * {@link RibbonX}.
- *
- * A tube is a ring buffer of `count` KNOTS along a centre-line. Each knot owns a
- * ring of `radial + 1` vertices: the extra vertex duplicates vertex 0 so the UV
- * seam (u = 0 meeting u = 1) closes cleanly when the texture wraps the tube.
- * Vertices are extruded in the vertex shader from the knot's stored tangent
- * frame, so the CPU only ever writes per-knot data (centre, frame, colour, …) —
- * never per-triangle.
- *
- * Like {@link RibbonX} the geometry is a fixed-capacity ring: {@link rotate}
- * recycles the oldest knot as the new head and rewrites a single segment's worth
- * of indices, so steady-state updates allocate nothing.
- *
- * **The knots are the tube; a drawable is what a renderer makes of them.** Nothing
- * here belongs to a renderer: {@link TubeXGeometry} wraps this data in three
- * attribute views for the legacy path, and the Shade path extrudes the same rows
- * into dynamic-mesh vertices. The three versions below are what tells either one
- * that its copy is stale.
- */
-export class TubeX {
-    /**
-     * The knot rows, interleaved per {@link tube_attributes_spec} — `vertex_count`
-     * records of `bytes_per_vertex` bytes, one per ring vertex.
-     *
-     * @returns {RowFirstTable}
-     */
-    get table(): RowFirstTable;
-    /**
-     * Triangle indices over the ring vertices, sized by {@link setCount} and
-     * rewritten one segment at a time by {@link rotate}.
-     *
-     * @returns {Uint32Array}
-     */
-    get indices(): Uint32Array;
-    /**
-     * @returns {number} bytes one ring vertex occupies in {@link table}
-     */
-    get bytes_per_vertex(): number;
-    /**
-     * @returns {number} ring vertices across the whole tube — `count * (radial + 1)`
-     */
-    get vertex_count(): number;
-    /**
-     * @returns {number}
-     */
-    get data_version(): number;
-    /**
-     * @returns {number}
-     */
-    get index_version(): number;
-    /**
-     * @returns {number}
-     */
-    get layout_version(): number;
-    /**
-     * @returns {number} number of knots
-     */
-    getCount(): number;
-    /**
-     * @returns {number} radial subdivisions
-     */
-    getRadialSegments(): number;
-    getHeadIndex(): number;
-    getTailIndex(): number;
-    /**
-     * @param {number[]|Float32Array|Float64Array} result
-     * @param {number} knot_index
-     */
-    getKnotPosition(result: number[] | Float32Array | Float64Array, knot_index: number): void;
-    /**
-     * Read the stored ring normal of a knot. Used by the head to parallel-transport
-     * its frame from the previous knot.
-     * @param {number[]|Float32Array|Float64Array} result
-     * @param {number} knot_index
-     */
-    getKnotNormal(result: number[] | Float32Array | Float64Array, knot_index: number): void;
-    /**
-     * Read the stored ring binormal of a knot.
-     * @param {number[]|Float32Array|Float64Array} result
-     * @param {number} knot_index
-     */
-    getKnotBinormal(result: number[] | Float32Array | Float64Array, knot_index: number): void;
-    /**
-     * Read a scalar attribute of a knot. Every vertex of the ring carries the same
-     * value, so the first one answers for the knot.
-     *
-     * @param {number} knot_index
-     * @param {number} attribute_index
-     * @returns {number}
-     */
-    getKnotAttribute_Scalar(knot_index: number, attribute_index: number): number;
-    /**
-     * Write a vec3 attribute to all ring vertices of a knot.
-     * @param {number} knot_index
-     * @param {number} attribute_index
-     * @param {number} x
-     * @param {number} y
-     * @param {number} z
-     */
-    setKnotAttribute_Vector3(knot_index: number, attribute_index: number, x: number, y: number, z: number): void;
-    /**
-     * Write a scalar attribute to all ring vertices of a knot.
-     * @param {number} knot_index
-     * @param {number} attribute_index
-     * @param {number} value
-     */
-    setKnotAttribute_Scalar(knot_index: number, attribute_index: number, value: number): void;
-    /**
-     * Add `delta` to a scalar attribute on every ring vertex of a knot.
-     * @param {number} knot_index
-     * @param {number} attribute_index
-     * @param {number} delta
-     * @returns {number} incremented value
-     */
-    incrementKnotAttribute_Scalar(knot_index: number, attribute_index: number, delta: number): number;
-    /**
-     * @param {number} knot_index
-     * @param {number} x
-     * @param {number} y
-     * @param {number} z
-     */
-    setKnotPosition(knot_index: number, x: number, y: number, z: number): void;
-    /**
-     * Set the orienting tangent frame of a knot. `nx,ny,nz` and `bx,by,bz` must be
-     * unit vectors, mutually orthogonal and perpendicular to the local tangent.
-     * @param {number} knot_index
-     * @param {number} nx
-     * @param {number} ny
-     * @param {number} nz
-     * @param {number} bx
-     * @param {number} by
-     * @param {number} bz
-     */
-    setKnotFrame(knot_index: number, nx: number, ny: number, nz: number, bx: number, by: number, bz: number): void;
-    /**
-     * Linear colour, stored at half precision. Not limited to 0..1: values above 1 are HDR.
-     *
-     * @param {number} knot_index
-     * @param {number} r
-     * @param {number} g
-     * @param {number} b
-     */
-    setKnotColor(knot_index: number, r: number, g: number, b: number): void;
-    /**
-     * @param {number} knot_index
-     * @param {number} value
-     */
-    setKnotAlpha(knot_index: number, value: number): void;
-    /**
-     * @param {number} knot_index
-     * @param {number} value tube diameter
-     */
-    setKnotThickness(knot_index: number, value: number): void;
-    /**
-     * @param {number} count number of knots (>= 2)
-     * @param {number} [radial] radial subdivisions (>= 3)
-     */
-    setCount(count: number, radial?: number): void;
-    /**
-     * NOTE: takes tube thickness into account.
-     * @param {AABB3|ArrayLike<number>} result
-     */
-    computeBoundingBox(result: AABB3 | ArrayLike<number>): void;
-    /**
-     * Recycle the oldest knot as the new head, in O(radial). Mirrors
-     * {@link RibbonX#rotate}: the head/tail pointers decrement together (preserving
-     * `head === (tail + 1) mod count`), and the single tail segment's indices are
-     * rewritten to bridge the previous head's ring to the recycled (new head) ring.
-     */
-    rotate(): void;
-    #private;
-}
-export namespace TubeX {
-    export { DEFAULT_RADIAL_SEGMENTS };
-}
-import { RowFirstTable } from "../../../../core/collection/table/RowFirstTable.js";
-/**
- * Default number of radial subdivisions around the tube. Overridable per-tube
- * via {@link TubeX#setCount}; never hard-coded into the geometry.
- * @type {number}
- */
-declare const DEFAULT_RADIAL_SEGMENTS: number;
-export {};
-//# sourceMappingURL=TubeX.d.ts.map

package/src/engine/graphics/trail/tube/TubeX.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"TubeX.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/trail/tube/TubeX.js"],"names":[],"mappings":"AA+BA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH;IAoEI;;;;;OAKG;IACH,2BAEC;IAED;;;;;OAKG;IACH,2BAEC;IAED;;OAEG;IACH,+BAEC;IAED;;OAEG;IACH,2BAEC;IAED;;OAEG;IACH,2BAEC;IAED;;OAEG;IACH,4BAEC;IAED;;OAEG;IACH,6BAEC;IAED;;OAEG;IACH,YAFa,MAAM,CAIlB;IAED;;OAEG;IACH,qBAFa,MAAM,CAIlB;IAED,uBAEC;IAED,uBAEC;IAiGD;;;OAGG;IACH,wBAHW,MAAM,EAAE,GAAC,YAAY,GAAC,YAAY,cAClC,MAAM,QAShB;IAED;;;;;OAKG;IACH,sBAHW,MAAM,EAAE,GAAC,YAAY,GAAC,YAAY,cAClC,MAAM,QAShB;IAED;;;;OAIG;IACH,wBAHW,MAAM,EAAE,GAAC,YAAY,GAAC,YAAY,cAClC,MAAM,QAShB;IAED;;;;;;;OAOG;IACH,oCAJW,MAAM,mBACN,MAAM,GACJ,MAAM,CAIlB;IAED;;;;;;;OAOG;IACH,qCANW,MAAM,mBACN,MAAM,KACN,MAAM,KACN,MAAM,KACN,MAAM,QAehB;IAED;;;;;OAKG;IACH,oCAJW,MAAM,mBACN,MAAM,SACN,MAAM,QAYhB;IAED;;;;;;OAMG;IACH,0CALW,MAAM,mBACN,MAAM,SACN,MAAM,GACJ,MAAM,CAgBlB;IAED;;;;;OAKG;IACH,4BALW,MAAM,KACN,MAAM,KACN,MAAM,KACN,MAAM,QAMhB;IAED;;;;;;;;;;OAUG;IACH,yBARW,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,QAKhB;IAED;;;;;;;OAOG;IACH,yBALW,MAAM,KACN,MAAM,KACN,MAAM,KACN,MAAM,QAMhB;IAED;;;OAGG;IACH,yBAHW,MAAM,SACN,MAAM,QAIhB;IAED;;;OAGG;IACH,6BAHW,MAAM,SACN,MAAM,QAIhB;IAED;;;OAGG;IACH,gBAHW,MAAM,WACN,MAAM,QAuChB;IAED;;;OAGG;IACH,2BAFW,QAAM,UAAU,MAAM,CAAC,QA4BjC;IAED;;;;;OAKG;IACH,eAsBC;;CACJ;;;;8BA3jB6B,oDAAoD;AAgBlF;;;;GAIG;AACH,uCAFU,MAAM,CAEkB"}