@rings-webgpu/core 1.0.49 → 1.0.51

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

@@ -28,8 +28,6 @@ export declare class PointCloudRenderer extends RenderNode {
     get positions(): Float32Array;
     private _colors;
     private _orderData;
-    private _fullCount;
-    get fullCount(): number;
     private _batchSize;
     instanceCount: number;
     private _texturesInitialized;

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

@@ -0,0 +1,126 @@
+import { RenderNode } from "./RenderNode";
+import { PointCloudMaterial } from "../../materials/PointCloudMaterial";
+import { View3D } from "../../core/View3D";
+import { RendererPassState } from "../../gfx/renderJob/passRenderer/state/RendererPassState";
+import { ClusterLightingBuffer } from "../../gfx/renderJob/passRenderer/cluster/ClusterLightingBuffer";
+import { PassType } from "../../gfx/renderJob/passRenderer/state/PassType";
+import { Uint8ArrayTexture } from "../../textures/Uint8ArrayTexture";
+import { Float32ArrayTexture } from "../../textures/Float32ArrayTexture";
+import { R32UintTexture } from "../../textures/R32UintTexture";
+import { Vector2 } from "../../math/Vector2";
+import { RenderContext } from "../../gfx/renderJob/passRenderer/RenderContext";
+import { Vector3 } from "../../math/Vector3";
+/**
+ * Point Cloud Data structure for streaming
+ */
+export type PointCloudData = {
+    position: [number, number, number];
+    color?: [number, number, number, number];
+};
+/**
+ * Point Cloud Stream Renderer Component
+ *
+ * Renders point clouds with streaming support, allowing incremental updates.
+ * Similar to GSplatStreamRenderer but for simple point clouds.
+ */
+export declare class PointCloudStreamRenderer extends RenderNode {
+    static flushFrameLimit: number;
+    totalCount: number;
+    size: Vector2;
+    pointColor: Uint8ArrayTexture;
+    pointPosition: Float32ArrayTexture;
+    pointOrder: R32UintTexture;
+    texParams: Float32Array;
+    private _texParamDirty;
+    pointCloudMaterial: PointCloudMaterial;
+    private _colorData;
+    private _positionData;
+    private _orderData;
+    private _pointSetFlags;
+    private _validCount;
+    private _batchSize;
+    instanceCount: number;
+    private _pendingUpdates;
+    private _autoFlushThreshold;
+    private _frameCount;
+    private _centerOffset;
+    get centerOffset(): Vector3;
+    private _texturesInitialized;
+    private _debugFullScreen;
+    constructor();
+    /**
+     * Initialize renderer with total point count
+     * Pre-allocates all GPU resources with zero-initialized data
+     * @param totalCount Total number of points that will be streamed
+     * @param batchSize Points per draw call (default: 128)
+     */
+    initCount(totalCount: number, batchSize?: number): void;
+    /**
+     * Set data for a single point at the given index
+     * Updates CPU buffers and marks for GPU update
+     * @param index Point index (0 to count-1)
+     * @param data Point data (position is required, color optional)
+     */
+    setPointCloudData(index: number, data: PointCloudData): void;
+    /**
+     * Update center offset for precision (called when new points are added)
+     */
+    private _updateCenterOffset;
+    /**
+     * Flush pending updates to GPU
+     * Updates GPU textures with all pending changes
+     * Uses partial updates when possible for better performance
+     */
+    flushUpdates(): void;
+    /**
+     * Set auto-flush threshold
+     * @param threshold Number of pending updates before auto-flush (default: 100)
+     */
+    setAutoFlushThreshold(threshold: number): void;
+    /**
+     * Get current streaming statistics
+     */
+    getStreamingStats(): {
+        totalCount: number;
+        validCount: number;
+        pendingUpdates: number;
+        progress: number;
+    };
+    /**
+     * Calculate texture size for given point count
+     * @param count Number of points
+     * @returns Texture dimensions (width, height)
+     */
+    private evalTextureSize;
+    /**
+     * Update node before rendering
+     */
+    nodeUpdate(view: View3D, passType: PassType, renderPassState: RendererPassState, clusterLightingBuffer?: ClusterLightingBuffer): void;
+    /**
+     * Render pass
+     */
+    renderPass(view: View3D, passType: PassType, renderContext: RenderContext): void;
+    /**
+     * Set point size in pixels
+     * @param size Point size in pixels
+     */
+    setPointSize(size: number): void;
+    /**
+     * Set point shape
+     * @param shape 'square' or 'circle'
+     */
+    setPointShape(shape: 'square' | 'circle'): void;
+    /**
+     * Enable a fullscreen debug quad to validate the render pipeline.
+     */
+    enableDebugFullScreen(enabled: boolean): void;
+    /**
+     * Set batch size for instanced rendering
+     * @param batchSize Number of points per draw call
+     */
+    setBatchSize(batchSize: number): void;
+    /**
+     * Clean up resources
+     */
+    destroy(force?: boolean): void;
+}

package/dist/types/index.d.ts

@@ -189,6 +189,7 @@ export * from "./components/renderer/InstanceDrawComponent";
 export * from "./components/renderer/MeshFilter";
 export * from "./components/renderer/MeshRenderer";
 export * from "./components/renderer/PointCloudRenderer";
+export * from "./components/renderer/PointCloudStreamRenderer";
 export * from "./components/renderer/Reflection";
 export * from "./components/renderer/RenderNode";
 export * from "./components/renderer/SkinnedMeshRenderer";

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

@@ -1,5 +1,20 @@
 import { Texture } from "../gfx/graphics/webGpu/core/texture/Texture";
 export declare class Float32ArrayTexture extends Texture {
+    private _dataBuffer;
     create(width: number, height: number, data: Float32Array, filtering?: boolean): this;
     fromBuffer(width: number, height: number, textureDataBuffer: GPUBuffer): this;
+    /**
+     * Clean up resources
+     */
+    destroy(force?: boolean): void;
+    /**
+     * Update texture content
+     * @param width Texture width
+     * @param height Texture height
+     * @param data Float32Array data (RGBA format: width * height * 4)
+     * @param filtering Whether to use filtering (default: true)
+     * @param startRow Start row for partial update (optional)
+     * @param rowCount Number of rows to update for partial update (optional)
+     */
+    updateTexture(width: number, height: number, data: Float32Array, filtering?: boolean, startRow?: number, rowCount?: number): void;
 }

package/package.json

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