@d5techs/3dgs-lib 1.1.0 → 1.1.1

package/dist/mesh/Mesh.d.ts

@@ -1,8 +1,4 @@
 import type { BoundingBox, Vec3Tuple } from "../types";
-/**
- * Mesh 包围盒类型别名（保持向后兼容）
- */
-export type MeshBoundingBox = BoundingBox;
 /**
  * Mesh - 网格数据结构
  * 存储 GPUBuffer + 变换属性
@@ -19,7 +15,7 @@ export declare class Mesh {
     rotation: Float32Array;
     scale: Float32Array;
     private localBoundingBox;
-    constructor(vertexBuffer: GPUBuffer, vertexCount: number, indexBuffer?: GPUBuffer | null, indexCount?: number, boundingBox?: MeshBoundingBox);
+    constructor(vertexBuffer: GPUBuffer, vertexCount: number, indexBuffer?: GPUBuffer | null, indexCount?: number, boundingBox?: BoundingBox);
     /**
      * 获取顶点 stride（字节数）
      */
@@ -27,15 +23,15 @@ export declare class Mesh {
     /**
      * 设置本地 bounding box
      */
-    setBoundingBox(bbox: MeshBoundingBox): void;
+    setBoundingBox(bbox: BoundingBox): void;
     /**
      * 获取本地 bounding box
      */
-    getLocalBoundingBox(): MeshBoundingBox | null;
+    getLocalBoundingBox(): BoundingBox | null;
     /**
      * 获取世界空间的 bounding box（考虑完整变换：缩放、旋转、平移）
      */
-    getWorldBoundingBox(): MeshBoundingBox | null;
+    getWorldBoundingBox(): BoundingBox | null;
     setPosition(x: number, y: number, z: number): void;
     getPosition(): Vec3Tuple;
     setRotation(rx: number, ry: number, rz: number): void;

package/dist/mesh/MeshRenderer.d.ts

@@ -1,6 +1,7 @@
 import { Renderer } from "../core/Renderer";
 import { Camera } from "../core/Camera";
-import { Mesh, MeshBoundingBox } from "./Mesh";
+import { Mesh } from "./Mesh";
+import type { BoundingBox } from "../types";
 import { MaterialData } from "../loaders/GLBLoader";
 /**
  * MeshRenderer - 网格渲染器
@@ -10,12 +11,17 @@ export declare class MeshRenderer {
     private renderer;
     private camera;
     private items;
+    private overlayItems;
     private pipelineTextured;
     private pipelineTexturedDoubleSided;
     private bindGroupLayoutTextured;
     private pipelineUntextured;
     private pipelineUntexturedDoubleSided;
     private bindGroupLayoutUntextured;
+    private overlayPipelineTextured;
+    private overlayPipelineTexturedDoubleSided;
+    private overlayPipelineUntextured;
+    private overlayPipelineUntexturedDoubleSided;
     private sampler;
     private defaultTexture;
     private lightDir;
@@ -28,15 +34,27 @@ export declare class MeshRenderer {
      */
     addMesh(mesh: Mesh, material?: MaterialData): void;
     /**
-     * 移除网格
+     * 移除网格（销毁 GPU 资源）
      */
     removeMesh(mesh: Mesh): void;
+    /**
+     * 从渲染列表中分离网格（不销毁 GPU 资源，可重新添加）
+     */
+    detachMesh(mesh: Mesh): void;
+    /**
+     * 添加覆盖层网格（使用带 depthBias 的管线，贴面不被 3DGS 深度遮挡）
+     */
+    addOverlayMesh(mesh: Mesh, material?: MaterialData): void;
+    /**
+     * 从覆盖层列表中分离网格（不销毁 vertex/index buffer）
+     */
+    detachOverlayMesh(mesh: Mesh): void;
     /**
      * 按索引移除网格
      */
     removeMeshByIndex(index: number): boolean;
     /**
-     * 清空所有网格
+     * 清空所有网格（含覆盖层）
      */
     clear(): void;
     /**
@@ -52,23 +70,21 @@ export declare class MeshRenderer {
      */
     getAmbientIntensity(): number;
     /**
-     * 渲染所有网格
+     * 渲染所有网格（普通 + 覆盖层）
      */
     render(pass: GPURenderPassEncoder): void;
+    private renderItems;
     getMeshCount(): number;
     getMeshByIndex(index: number): Mesh | null;
-    /**
-     * 获取指定索引网格的材质颜色
-     */
     getMeshColor(index: number): [number, number, number, number] | null;
-    /**
-     * 设置指定索引网格的材质颜色
-     */
     setMeshColor(index: number, r: number, g: number, b: number, a?: number): boolean;
-    /**
-     * 设置指定范围内所有网格的材质颜色
-     */
     setMeshRangeColor(startIndex: number, count: number, r: number, g: number, b: number, a?: number): number;
-    getCombinedBoundingBox(): MeshBoundingBox | null;
+    getOverlayMeshCount(): number;
+    getOverlayMeshByIndex(index: number): Mesh | null;
+    removeOverlayMeshByIndex(index: number): boolean;
+    getOverlayMeshColor(index: number): [number, number, number, number] | null;
+    setOverlayMeshColor(index: number, r: number, g: number, b: number, a?: number): boolean;
+    setOverlayMeshRangeColor(startIndex: number, count: number, r: number, g: number, b: number, a?: number): number;
+    getCombinedBoundingBox(): BoundingBox | null;
     destroy(): void;
 }

package/dist/scene/SceneManager.d.ts

@@ -6,7 +6,7 @@
  * - Splat 点云
  * - 场景查询（bounding box 等）
  */
-import { Mesh, MeshBoundingBox } from "../mesh/Mesh";
+import { Mesh } from "../mesh/Mesh";
 import { MeshRenderer } from "../mesh/MeshRenderer";
 import type { IGSSplatRenderer } from "../gs/IGSSplatRenderer";
 import type { BoundingBox, Vec3Tuple } from "../types";
@@ -61,6 +61,12 @@ export declare class SceneManager {
      * 按索引移除 Mesh
      */
     removeMeshByIndex(index: number): boolean;
+    getOverlayMeshCount(): number;
+    getOverlayMeshByIndex(index: number): Mesh | null;
+    getOverlayMeshRange(startIndex: number, count: number): Mesh[];
+    removeOverlayMeshByIndex(index: number): boolean;
+    getOverlayMeshColor(index: number): [number, number, number, number] | null;
+    setOverlayMeshRangeColor(startIndex: number, count: number, r: number, g: number, b: number, a?: number): number;
     /**
      * 获取 Splat 数量
      */
@@ -104,7 +110,7 @@ export declare class SceneManager {
     /**
      * 获取 Mesh 的组合 bounding box
      */
-    getMeshBoundingBox(): MeshBoundingBox | null;
+    getBoundingBox(): BoundingBox | null;
     /**
      * 获取 Splat 的 bounding box
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@d5techs/3dgs-lib",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "可扩展的 WebGPU 3D 渲染引擎",
   "type": "module",
   "main": "./dist/3dgs-lib.cjs",
@@ -58,5 +58,8 @@
     "@webgpu/types": {
       "optional": true
     }
+  },
+  "dependencies": {
+    "fflate": "^0.8.2"
   }
 }