@rings-webgpu/core 1.0.11 → 1.0.12

package/dist/types/assets/shader/core/base/Common_frag.d.ts

@@ -1 +1,4 @@
+/**
+ * @internal
+ */
 export declare let Common_frag: string;

package/dist/types/assets/shader/core/struct/VertexAttributes.d.ts

@@ -1 +1,4 @@
+/**
+ * @internal
+ */
 export declare let VertexAttributes_vert: string;

package/dist/types/assets/shader/lines/FatLineShader.d.ts

@@ -0,0 +1,5 @@
+/**
+ * FatLine Shader - Complete shader combining vertex, fragment and uniforms
+ */
+export declare const FatLine_VS: string;
+export declare const FatLine_FS: string;

package/dist/types/components/renderer/FatLineRenderer.d.ts

@@ -0,0 +1,38 @@
+import { Object3D } from "../../core/entities/Object3D";
+import { RenderNode } from "./RenderNode";
+import { FatLineMaterial } from "../../materials/FatLineMaterial";
+import { FatLineGeometry } from "../../core/geometry/FatLineGeometry";
+import { View3D } from "../../core/View3D";
+import { PassType } from "../../gfx/renderJob/passRenderer/state/PassType";
+import { RendererPassState } from "../../gfx/renderJob/passRenderer/state/RendererPassState";
+import { ClusterLightingBuffer } from "../../gfx/renderJob/passRenderer/cluster/ClusterLightingBuffer";
+/**
+ * FatLine Renderer Component
+ * Specialized renderer for FatLine geometries that automatically updates
+ * model matrix and resolution uniforms each frame
+ *
+ * @group Components
+ */
+export declare class FatLineRenderer extends RenderNode {
+    private _fatLineMaterial;
+    private _fatLineGeometry;
+    constructor();
+    onEnable(): void;
+    onDisable(): void;
+    cloneTo(obj: Object3D): void;
+    copyComponent(from: this): this;
+    /**
+     * Set FatLine geometry
+     */
+    set geometry(value: FatLineGeometry);
+    get geometry(): FatLineGeometry;
+    /**
+     * Set FatLine material
+     */
+    set material(value: FatLineMaterial);
+    get material(): FatLineMaterial;
+    /**
+     * Override nodeUpdate to automatically update FatLine-specific uniforms
+     */
+    nodeUpdate(view: View3D, passType: PassType, renderPassState: RendererPassState, clusterLightingBuffer?: ClusterLightingBuffer): void;
+}

package/dist/types/core/geometry/FatLineGeometry.d.ts

@@ -0,0 +1,48 @@
+import { GeometryBase } from "./GeometryBase";
+import { StorageGPUBuffer } from "../../gfx/graphics/webGpu/core/buffer/StorageGPUBuffer";
+/**
+ * FatLine Geometry
+ * Using instance rendering, each line segment as an instance
+ * @group Geometry
+ */
+export declare class FatLineGeometry extends GeometryBase {
+    private _instanceBuffer;
+    private _instanceData;
+    private _instanceCount;
+    constructor();
+    /**
+     * Initialize base quad geometry (shared by all line segments)
+     * This is similar to ThreeJS LineSegmentsGeometry base geometry
+     */
+    private initBaseGeometry;
+    /**
+     * Set line positions from continuous points array
+     * @param positions Array of positions [x1,y1,z1, x2,y2,z2, ...]
+     */
+    setPositions(positions: Float32Array | number[]): this;
+    /**
+     * Set colors for line segments
+     * @param colors Array of colors [r1,g1,b1, r2,g2,b2, ...] for each point
+     */
+    setColors(colors: Float32Array | number[]): this;
+    /**
+     * Compute bounding box from positions
+     */
+    private computeBoundingBox;
+    /**
+     * Get instance data for GPU upload
+     */
+    get instanceData(): Float32Array;
+    /**
+     * Get number of line segments (instances)
+     */
+    get instanceCount(): number;
+    /**
+     * Get or create instance buffer
+     */
+    get instanceBuffer(): StorageGPUBuffer;
+    /**
+     * Update instance buffer with new data
+     */
+    updateInstanceBuffer(): void;
+}

package/dist/types/index.d.ts

@@ -64,6 +64,7 @@ export * from "./assets/shader/core/struct/VertexAttributeIndexShader";
 export * from "./assets/shader/core/struct/VertexAttributes";
 export * from "./assets/shader/env/ReflectionCG";
 export * from "./assets/shader/glsl/Quad_glsl";
+export * from "./assets/shader/gsplat/GSplatShader";
 export * from "./assets/shader/lighting/BRDF_frag";
 export * from "./assets/shader/lighting/BsDF_frag";
 export * from "./assets/shader/lighting/BxDF_frag";
@@ -73,9 +74,9 @@ export * from "./assets/shader/lighting/IrradianceVolumeData_frag";
 export * from "./assets/shader/lighting/Irradiance_frag";
 export * from "./assets/shader/lighting/LightingFunction_frag";
 export * from "./assets/shader/lighting/UnLit_frag";
+export * from "./assets/shader/lines/FatLineShader";
 export * from "./assets/shader/materials/ColorLitShader";
 export * from "./assets/shader/materials/GIProbeShader";
-export * from "./assets/shader/materials/GSplatShader";
 export * from "./assets/shader/materials/GlassShader";
 export * from "./assets/shader/materials/Hair_shader";
 export * from "./assets/shader/materials/Lambert_shader";
@@ -179,6 +180,7 @@ export * from "./components/lights/LightData";
 export * from "./components/lights/PointLight";
 export * from "./components/lights/SpotLight";
 export * from "./components/post/PostProcessingComponent";
+export * from "./components/renderer/FatLineRenderer";
 export * from "./components/renderer/GSplatRenderer";
 export * from "./components/renderer/GlobalIlluminationComponent";
 export * from "./components/renderer/InstanceDrawComponent";
@@ -212,6 +214,7 @@ export * from "./core/entities/Entity";
 export * from "./core/entities/InstancedMesh";
 export * from "./core/entities/Object3D";
 export * from "./core/geometry/ExtrudeGeometry";
+export * from "./core/geometry/FatLineGeometry";
 export * from "./core/geometry/GeometryBase";
 export * from "./core/geometry/GeometryIndicesBuffer";
 export * from "./core/geometry/GeometryVertexBuffer";
@@ -432,6 +435,8 @@ export * from "./loader/parser/prefab/PrefabParser";
 export * from "./loader/parser/prefab/PrefabStringUtil";
 export * from "./loader/parser/prefab/PrefabTextureParser";
 export * from "./loader/parser/prefab/mats/MaterialUtilities";
+export * from "./loader/parser/prefab/mats/shader/FatLineShader";
+export * from "./loader/parser/prefab/mats/shader/GSplatShader";
 export * from "./loader/parser/prefab/mats/shader/LitSSSShader";
 export * from "./loader/parser/prefab/mats/shader/LitShader";
 export * from "./loader/parser/prefab/mats/shader/QuadShader";
@@ -454,6 +459,7 @@ export * from "./loader/parser/tileRenderer/TileSet";
 export * from "./loader/parser/tileRenderer/TilesRenderer";
 export * from "./materials/BlendMode";
 export * from "./materials/ColorLitMaterial";
+export * from "./materials/FatLineMaterial";
 export * from "./materials/GIProbeMaterial";
 export * from "./materials/GSplatMaterial";
 export * from "./materials/LambertMaterial";

package/dist/types/loader/parser/prefab/mats/shader/FatLineShader.d.ts

@@ -0,0 +1,11 @@
+import { Shader } from "../../../../../gfx/graphics/webGpu/shader/Shader";
+/**
+ * FatLine Shader
+ */
+export declare class FatLineShader extends Shader {
+    constructor();
+    /**
+     * Set default uniform values
+     */
+    setDefault(): void;
+}

package/dist/types/loader/parser/prefab/mats/shader/GSplatShader.d.ts

@@ -0,0 +1,12 @@
+import { Shader } from "../../../../../gfx/graphics/webGpu/shader/Shader";
+/**
+ * GSplat Shader
+ * Shader for rendering 3D Gaussian Splats
+ */
+export declare class GSplatShader extends Shader {
+    constructor();
+    /**
+     * Set default uniform values
+     */
+    setDefault(): void;
+}

package/dist/types/materials/FatLineMaterial.d.ts

@@ -0,0 +1,57 @@
+import { Material } from "./Material";
+import { Color } from "../math/Color";
+import { Vector2 } from "../math/Vector2";
+import { Matrix4 } from "../math/Matrix4";
+import { StorageGPUBuffer } from "../gfx/graphics/webGpu/core/buffer/StorageGPUBuffer";
+/**
+ * FatLine Material
+ * Material for rendering thick lines
+ * Supports pixel-accurate line width and round endcaps
+ * @group Material
+ */
+export declare class FatLineMaterial extends Material {
+    constructor();
+    /**
+     * Set instance buffer for line segments
+     * This should be called after setting the geometry
+     */
+    setInstanceBuffer(buffer: StorageGPUBuffer): void;
+    /**
+     * Set model matrix for transforming line segments
+     * This should be updated each frame if the object moves
+     */
+    setModelMatrix(matrix: Matrix4): void;
+    /**
+     * Set base color (tint color)
+     */
+    set baseColor(color: Color);
+    /**
+     * Get base color (tint color)
+     */
+    get baseColor(): Color;
+    /**
+     * Set line width in pixels
+     */
+    set lineWidth(value: number);
+    /**
+     * Get line width in pixels
+     */
+    get lineWidth(): number;
+    /**
+     * Set opacity (0-1)
+     */
+    set opacity(value: number);
+    /**
+     * Get opacity (0-1)
+     */
+    get opacity(): number;
+    /**
+     * Set viewport resolution for correct pixel-space calculations
+     * This should be set automatically by the renderer
+     */
+    set resolution(value: Vector2);
+    /**
+     * Get viewport resolution
+     */
+    get resolution(): Vector2;
+}

package/dist/types/materials/GSplatMaterial.d.ts

@@ -3,6 +3,11 @@ import { Float16ArrayTexture } from "../textures/Float16ArrayTexture";
 import { Uint8ArrayTexture } from "../textures/Uint8ArrayTexture";
 import { Uint32ArrayTexture } from "../textures/Uint32ArrayTexture";
 import { Matrix4 } from "../math/Matrix4";
+/**
+ * GSplat Material
+ * Material for rendering 3D Gaussian Splats
+ * @group Material
+ */
 export declare class GSplatMaterial extends Material {
     constructor();
     setSplatTextures(splatColor: Uint8ArrayTexture, transformA: Uint32ArrayTexture, transformB: Float16ArrayTexture, texParams: Float32Array, splatOrder?: Uint32ArrayTexture): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rings-webgpu/core",
-  "version": "1.0.11",
+  "version": "1.0.12",
   "description": "Rings webgpu Engine",
   "main": "index.js",
   "exports": {