@rings-webgpu/core 1.0.27 → 1.0.28

package/dist/types/assets/shader/pointcloud/PointCloudShader.d.ts

@@ -0,0 +1,2 @@
+export declare const PointCloud_VS: string;
+export declare const PointCloud_FS: string;

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

@@ -0,0 +1,89 @@
+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 Renderer Component
+ *
+ * Renders point clouds with billboard quads using instanced rendering.
+ * Manages point data, textures, and rendering state.
+ */
+export declare class PointCloudRenderer extends RenderNode {
+    count: number;
+    size: Vector2;
+    pointColor: Uint8ArrayTexture;
+    pointPosition: Float32ArrayTexture;
+    pointOrder: R32UintTexture;
+    texParams: Float32Array;
+    pointCloudMaterial: PointCloudMaterial;
+    private _positions;
+    get positions(): Float32Array;
+    private _colors;
+    private _orderData;
+    private _fullCount;
+    get fullCount(): number;
+    private _batchSize;
+    instanceCount: number;
+    private _texturesInitialized;
+    private _debugFullScreen;
+    private _centerOffset;
+    get centerOffset(): Vector3;
+    constructor();
+    /**
+     * Initialize point cloud from raw data
+     * @param positions Point positions (xyz per point, Float32Array)
+     * @param colors Point colors (rgba per point, Uint8Array)
+     * @param count Number of points
+     */
+    initFromData(positions: Float32Array, colors: Uint8Array, count: number): void;
+    /**
+     * Calculate texture size for given point count
+     * @param count Number of points
+     * @returns Texture dimensions (width, height)
+     */
+    private evalTextureSize;
+    /**
+     * Centerize positions to improve precision for large values
+     * Subtracts the center point from all positions to keep values near zero
+     */
+    private centerizePositions;
+    private buildPositionTexture;
+    private buildColorTexture;
+    private buildOrderTexture;
+    /**
+     * 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;
+    destroy(force?: boolean): void;
+}

package/dist/types/gfx/graphics/webGpu/shader/RenderShaderPass.d.ts

@@ -55,6 +55,7 @@ export declare class RenderShaderPass extends ShaderPassBase {
     get depthCompare(): GPUCompareFunction;
     set depthCompare(value: GPUCompareFunction);
     setShaderEntry(vsEntryPoint?: string, fsEntryPoint?: string): void;
+    setUniformArray(name: string, value: Float32Array): void;
     setUniform(name: string, value: UniformValue): void;
     setTexture(name: string, texture: Texture): void;
     get baseColor(): Color;

package/dist/types/index.d.ts

@@ -98,6 +98,7 @@ export * from "./assets/shader/materials/uniforms/VideoUniform_frag";
 export * from "./assets/shader/math/FastMathShader";
 export * from "./assets/shader/math/MathShader";
 export * from "./assets/shader/math/MatrixShader";
+export * from "./assets/shader/pointcloud/PointCloudShader";
 export * from "./assets/shader/post/FXAAShader";
 export * from "./assets/shader/post/GlobalFog_shader";
 export * from "./assets/shader/quad/Quad_shader";
@@ -186,6 +187,7 @@ export * from "./components/renderer/GlobalIlluminationComponent";
 export * from "./components/renderer/InstanceDrawComponent";
 export * from "./components/renderer/MeshFilter";
 export * from "./components/renderer/MeshRenderer";
+export * from "./components/renderer/PointCloudRenderer";
 export * from "./components/renderer/Reflection";
 export * from "./components/renderer/RenderNode";
 export * from "./components/renderer/SkinnedMeshRenderer";
@@ -441,6 +443,7 @@ 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/PointCloudShader";
 export * from "./loader/parser/prefab/mats/shader/QuadShader";
 export * from "./loader/parser/prefab/mats/shader/ReflectionShader";
 export * from "./loader/parser/prefab/mats/shader/SkyShader";
@@ -477,6 +480,7 @@ export * from "./materials/LambertMaterial";
 export * from "./materials/LitMaterial";
 export * from "./materials/Material";
 export * from "./materials/MaterialRegister";
+export * from "./materials/PointCloudMaterial";
 export * from "./materials/ReflectionMaterial";
 export * from "./materials/SkyMaterial";
 export * from "./materials/UnLitMaterial";
@@ -558,6 +562,7 @@ export * from "./shape/BoxGeometry";
 export * from "./shape/CylinderGeometry";
 export * from "./shape/GSplatGeometry";
 export * from "./shape/PlaneGeometry";
+export * from "./shape/PointCloudGeometry";
 export * from "./shape/SphereGeometry";
 export * from "./shape/TorusGeometry";
 export * from "./shape/TrailGeometry";

package/dist/types/loader/parser/ply/PlyLoader.d.ts

@@ -1,4 +1,4 @@
-import { PlyHeader, PlyGaussianSplatData, PlyMeshData } from './PlyTypes';
+import { PlyHeader, PlyGaussianSplatData, PlyMeshData, PlyPointCloudData } from './PlyTypes';
 /**
  * Parse PLY header from buffer
  */
@@ -11,3 +11,7 @@ export declare function parsePlyGaussianSplat(buffer: ArrayBuffer): PlyGaussianS
  * Parse PLY data for Mesh
  */
 export declare function parsePlyMesh(buffer: ArrayBuffer): PlyMeshData;
+/**
+ * Parse PLY data for Point Cloud (supports both binary and ASCII)
+ */
+export declare function parsePlyPointCloud(buffer: ArrayBuffer): PlyPointCloudData;

package/dist/types/loader/parser/ply/PlyTypes.d.ts

@@ -53,3 +53,11 @@ export type PlyMeshData = {
     textureFiles?: string[];
     triangleTexnumbers?: number[];
 };
+/**
+ * Parsed PLY data for Point Cloud
+ */
+export type PlyPointCloudData = {
+    vertexCount: number;
+    position: Float32Array;
+    color?: Uint8Array;
+};

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

@@ -0,0 +1,9 @@
+import { Shader } from "../../../../../gfx/graphics/webGpu/shader/Shader";
+/**
+ * PointCloud Shader
+ * Shader for rendering point clouds with billboard quads
+ */
+export declare class PointCloudShader extends Shader {
+    constructor();
+    setDefault(): void;
+}

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

@@ -0,0 +1,44 @@
+import { Material } from "./Material";
+import { Float32ArrayTexture } from "../textures/Float32ArrayTexture";
+import { Uint8ArrayTexture } from "../textures/Uint8ArrayTexture";
+import { R32UintTexture } from "../textures/R32UintTexture";
+import { Matrix4 } from "../math/Matrix4";
+/**
+ * PointCloud Material
+ * Material for rendering point clouds with billboard quads
+ * @group Material
+ */
+export declare class PointCloudMaterial extends Material {
+    private _texParams;
+    private _pointParamsArray;
+    constructor();
+    /**
+     * Set point cloud textures
+     * @param pointPosition Position texture (RGB = xyz)
+     * @param pointColor Color texture (RGBA)
+     * @param texParams Texture parameters [numPoints, texWidth, validCount, pointSize]
+     * @param pointOrder Optional sorting texture (R32U format)
+     */
+    setPointTextures(pointPosition: Float32ArrayTexture, pointColor: Uint8ArrayTexture, texParams: Float32Array, pointOrder?: R32UintTexture): void;
+    /**
+     * Set the model matrix for transforming points to world space
+     * @param matrix Model transformation matrix
+     */
+    setTransformMatrix(matrix: Matrix4): void;
+    /**
+     * Set point size in pixels
+     * @param size Point size in pixels (default: 4.0)
+     */
+    setPointSize(size: number): void;
+    /**
+     * Set point shape
+     * @param shape Point shape: 'square' or 'circle'
+     */
+    setPointShape(shape: 'square' | 'circle'): void;
+    enableDebugFullScreen(enabled: boolean): void;
+    /**
+     * Set batch size for instanced rendering
+     * @param batchSize Number of points per draw call (default: 128)
+     */
+    setBatchSize(batchSize: number): void;
+}

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

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

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

@@ -0,0 +1,5 @@
+import { GeometryBase } from "../core/geometry/GeometryBase";
+export declare class PointCloudGeometry extends GeometryBase {
+    batchSize: number;
+    constructor(batchSize?: number);
+}

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

@@ -1,5 +1,5 @@
 import { Texture } from "../gfx/graphics/webGpu/core/texture/Texture";
 export declare class Float32ArrayTexture extends Texture {
-    create(width: number, height: number, data: Float32Array, filtering?: boolean): void;
+    create(width: number, height: number, data: Float32Array, filtering?: boolean): this;
     fromBuffer(width: number, height: number, textureDataBuffer: GPUBuffer): this;
 }

package/dist/types/util/BoundUtil.d.ts

@@ -7,6 +7,7 @@ export declare class BoundUtil {
     private static readonly genMeshMaxVector;
     private static readonly genMeshMinVector;
     private static readonly genMeshVectorList8;
+    static genPointCloudBounds(obj: Object3D, bound?: BoundingBox): BoundingBox;
     static genGSplatBounds(obj: Object3D, bound?: BoundingBox): BoundingBox;
     static genMeshBounds(obj: Object3D, bound?: BoundingBox): BoundingBox;
     static transformBound(matrix: Matrix4, source: BoundingBox, bound?: BoundingBox): BoundingBox;

package/package.json

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