@rings-webgpu/core 1.0.11 → 1.0.13

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/components/renderer/GSplatRenderer.d.ts

@@ -7,6 +7,7 @@ import { PassType } from "../../gfx/renderJob/passRenderer/state/PassType";
 import { GaussianSplatAsset } from "../../loader/parser/3dgs/GaussianSplatAsset";
 import { Uint8ArrayTexture } from "../../textures/Uint8ArrayTexture";
 import { Uint32ArrayTexture } from "../../textures/Uint32ArrayTexture";
+import { R32UintTexture } from "../../textures/R32UintTexture";
 import { Float16ArrayTexture } from "../../textures/Float16ArrayTexture";
 import { Vector2 } from "../../math/Vector2";
 /**
@@ -22,7 +23,7 @@ export declare class GSplatRenderer extends RenderNode {
     transformA: Uint32ArrayTexture;
     transformB: Float16ArrayTexture;
     texParams: Float32Array;
-    splatOrder: Uint32ArrayTexture;
+    splatOrder: R32UintTexture;
     gsplatMaterial: GSplatMaterial;
     private _positions;
     get positions(): Float32Array;
@@ -35,6 +36,8 @@ export declare class GSplatRenderer extends RenderNode {
     private _lastViewMatrixHash;
     private _lastCameraSpeed;
     private _adaptiveSorting;
+    private _lastPixelCullParams;
+    private _texturesInitialized;
     private _lodEnabled;
     private _lodDistances;
     private _lodRatios;
@@ -45,6 +48,8 @@ export declare class GSplatRenderer extends RenderNode {
     private _mapping;
     private _fullCount;
     get fullCount(): number;
+    private _batchSize;
+    instanceCount: number;
     constructor();
     /**
      * Initialize from Gaussian Splat asset
@@ -108,6 +113,16 @@ export declare class GSplatRenderer extends RenderNode {
         maxEnabled: boolean;
         distanceEnabled: boolean;
     };
+    /**
+     * Get batching statistics
+     */
+    getBatchingStats(): {
+        enabled: boolean;
+        batchSize: number;
+        instanceCount: number;
+        splatCount: number;
+        reduction: number;
+    };
     /**
      * Calculate texture size for given splat count
      */
@@ -136,10 +151,6 @@ export declare class GSplatRenderer extends RenderNode {
      * Update node before rendering
      */
     nodeUpdate(view: View3D, passType: PassType, renderPassState: RendererPassState, clusterLightingBuffer?: ClusterLightingBuffer): void;
-    /**
-     * Render pass
-     */
-    renderPass2(view: View3D, passType: PassType, rendererPassState: RendererPassState, clusterLightingBuffer: ClusterLightingBuffer, encoder: GPURenderPassEncoder, useBundle?: boolean): void;
     /**
      * Render pass (fallback)
      */

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/gfx/renderJob/jobs/RendererJob.d.ts

@@ -18,7 +18,8 @@ export declare class RendererJob {
     shadowMapPassRenderer: ShadowMapPassRenderer;
     pointLightShadowRenderer: PointLightShadowRenderer;
     ddgiProbeRenderer: DDGIProbeRenderer;
-    postRenderer: PostRenderer;
+    _postRenderer: PostRenderer;
+    get postRenderer(): PostRenderer;
     clusterLightingRender: ClusterLightingRender;
     reflectionRenderer: ReflectionRenderer;
     occlusionSystem: OcclusionSystem;

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";
@@ -539,6 +545,7 @@ export * from "./setting/post/SSRSetting";
 export * from "./setting/post/TAASetting";
 export * from "./shape/BoxGeometry";
 export * from "./shape/CylinderGeometry";
+export * from "./shape/GSplatGeometry";
 export * from "./shape/PlaneGeometry";
 export * from "./shape/SphereGeometry";
 export * from "./shape/TorusGeometry";
@@ -555,6 +562,7 @@ export * from "./textures/Float32ArrayTexture";
 export * from "./textures/HDRTexture";
 export * from "./textures/HDRTextureCube";
 export * from "./textures/LDRTextureCube";
+export * from "./textures/R32UintTexture";
 export * from "./textures/RenderTexture";
 export * from "./textures/SolidColorSky";
 export * from "./textures/TextureCubeFaceData";

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

@@ -2,10 +2,17 @@ import { Material } from "./Material";
 import { Float16ArrayTexture } from "../textures/Float16ArrayTexture";
 import { Uint8ArrayTexture } from "../textures/Uint8ArrayTexture";
 import { Uint32ArrayTexture } from "../textures/Uint32ArrayTexture";
+import { R32UintTexture } from "../textures/R32UintTexture";
 import { Matrix4 } from "../math/Matrix4";
+/**
+ * GSplat Material
+ * Material for rendering 3D Gaussian Splats
+ * @group Material
+ */
 export declare class GSplatMaterial extends Material {
+    private _pixelCullArray;
     constructor();
-    setSplatTextures(splatColor: Uint8ArrayTexture, transformA: Uint32ArrayTexture, transformB: Float16ArrayTexture, texParams: Float32Array, splatOrder?: Uint32ArrayTexture): void;
+    setSplatTextures(splatColor: Uint8ArrayTexture, transformA: Uint32ArrayTexture, transformB: Float16ArrayTexture, texParams: Float32Array, splatOrder?: R32UintTexture): void;
     /**
      * Set the model matrix for transforming splats to world space
      */
@@ -16,5 +23,5 @@ export declare class GSplatMaterial extends Material {
      * @param maxPixels Maximum pixel coverage (cull oversized splats), default: 0 (disabled)
      * @param maxPixelCullDistance Only cull oversized splats within this distance, 0 = always cull
      */
-    setPixelCulling(minPixels: number, maxPixels: number, maxPixelCullDistance?: number): void;
+    setPixelCulling(minPixels: number, maxPixels: number, maxPixelCullDistance?: number, batchSize?: number): void;
 }

package/dist/types/shape/GSplatGeometry.d.ts

@@ -0,0 +1,13 @@
+import { GeometryBase } from "../core/geometry/GeometryBase";
+/**
+ * GSplat Geometry (PlayCanvas Style)
+ *
+ * Exactly like PlayCanvas gsplat-instance.js:
+ * - batchSize splats per draw call (default 128)
+ * - Each splat = 4 vertices (x, y, local_index)
+ * - Each splat = 6 indices (2 triangles)
+ */
+export declare class GSplatGeometry extends GeometryBase {
+    batchSize: number;
+    constructor(batchSize?: number);
+}

package/dist/types/textures/R32UintTexture.d.ts

@@ -0,0 +1,11 @@
+import { Texture } from "../gfx/graphics/webGpu/core/texture/Texture";
+/**
+ * @internal
+ * R32Uint texture backed by Uint32Array
+ * @group Texture
+ */
+export declare class R32UintTexture extends Texture {
+    private _dataBuffer;
+    create(width: number, height: number, data: Uint32Array): this;
+    updateTexture(width: number, height: number, data: Uint32Array): void;
+}

package/package.json

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