@d5techs/3dgs-lib 1.0.0

package/dist/mesh/MeshRenderer.d.ts

@@ -0,0 +1,74 @@
+import { Renderer } from "../core/Renderer";
+import { Camera } from "../core/Camera";
+import { Mesh, MeshBoundingBox } from "./Mesh";
+import { MaterialData } from "../loaders/GLBLoader";
+/**
+ * MeshRenderer - 网格渲染器
+ * 支持纹理和材质，每个 mesh 有独立的 uniform buffer
+ */
+export declare class MeshRenderer {
+    private renderer;
+    private camera;
+    private items;
+    private pipelineTextured;
+    private pipelineTexturedDoubleSided;
+    private bindGroupLayoutTextured;
+    private pipelineUntextured;
+    private pipelineUntexturedDoubleSided;
+    private bindGroupLayoutUntextured;
+    private sampler;
+    private defaultTexture;
+    private lightDir;
+    private ambientIntensity;
+    constructor(renderer: Renderer, camera: Camera);
+    private createResources;
+    private createPipelines;
+    /**
+     * 添加网格（带材质）- 每个 mesh 创建独立的 uniform buffer
+     */
+    addMesh(mesh: Mesh, material?: MaterialData): void;
+    /**
+     * 移除网格
+     */
+    removeMesh(mesh: Mesh): void;
+    /**
+     * 按索引移除网格
+     */
+    removeMeshByIndex(index: number): boolean;
+    /**
+     * 清空所有网格
+     */
+    clear(): void;
+    /**
+     * 设置光照方向
+     */
+    setLightDirection(x: number, y: number, z: number): void;
+    /**
+     * 设置环境光强度
+     */
+    setAmbientIntensity(intensity: number): void;
+    /**
+     * 获取环境光强度
+     */
+    getAmbientIntensity(): number;
+    /**
+     * 渲染所有网格
+     */
+    render(pass: GPURenderPassEncoder): void;
+    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;
+    destroy(): void;
+}

package/dist/scene/SceneManager.d.ts

@@ -0,0 +1,136 @@
+/**
+ * SceneManager - 场景管理器
+ *
+ * 负责管理场景中的所有对象：
+ * - Mesh 网格
+ * - Splat 点云
+ * - 场景查询（bounding box 等）
+ */
+import { Mesh } from "../mesh/Mesh";
+import { MeshRenderer } from "../mesh/MeshRenderer";
+import { IGSSplatRenderer, BoundingBox } from "../gs/IGSSplatRenderer";
+import { MeshBoundingBox } from "../mesh/Mesh";
+/**
+ * 场景对象类型
+ */
+export type SceneObjectType = 'mesh' | 'splat' | 'meshGroup';
+/**
+ * 场景对象信息
+ */
+export interface SceneObjectInfo {
+    type: SceneObjectType;
+    index: number;
+    name?: string;
+}
+/**
+ * SceneManager - 场景管理器
+ */
+export declare class SceneManager {
+    private meshRenderer;
+    private gsRenderer;
+    constructor(meshRenderer: MeshRenderer);
+    /**
+     * 设置 GS Splat 渲染器
+     */
+    setGSRenderer(renderer: IGSSplatRenderer | null): void;
+    /**
+     * 获取 GS Splat 渲染器
+     */
+    getGSRenderer(): IGSSplatRenderer | null;
+    /**
+     * 是否有 Splat 数据
+     */
+    hasSplats(): boolean;
+    /**
+     * 获取 Mesh 数量
+     */
+    getMeshCount(): number;
+    /**
+     * 获取指定索引的 Mesh
+     */
+    getMeshByIndex(index: number): Mesh | null;
+    /**
+     * 获取指定范围的 Mesh
+     */
+    getMeshRange(startIndex: number, count: number): Mesh[];
+    /**
+     * 清空所有 Mesh
+     */
+    clearMeshes(): void;
+    /**
+     * 按索引移除 Mesh
+     */
+    removeMeshByIndex(index: number): boolean;
+    /**
+     * 获取 Splat 数量
+     */
+    getSplatCount(): number;
+    /**
+     * 清空 Splats
+     */
+    clearSplats(): void;
+    /**
+     * 设置 Splat 位置
+     */
+    setSplatPosition(x: number, y: number, z: number): void;
+    /**
+     * 获取 Splat 位置
+     */
+    getSplatPosition(): [number, number, number] | null;
+    /**
+     * 设置 Splat 旋转
+     */
+    setSplatRotation(x: number, y: number, z: number): void;
+    /**
+     * 获取 Splat 旋转
+     */
+    getSplatRotation(): [number, number, number] | null;
+    /**
+     * 设置 Splat 缩放
+     */
+    setSplatScale(x: number, y: number, z: number): void;
+    /**
+     * 获取 Splat 缩放
+     */
+    getSplatScale(): [number, number, number] | null;
+    /**
+     * 设置 SH 模式
+     */
+    setSHMode(mode: 0 | 1 | 2 | 3): void;
+    /**
+     * 获取当前 SH 模式
+     */
+    getSHMode(): number;
+    /**
+     * 获取 Mesh 的组合 bounding box
+     */
+    getMeshBoundingBox(): MeshBoundingBox | null;
+    /**
+     * 获取 Splat 的 bounding box
+     */
+    getSplatBoundingBox(): BoundingBox | null;
+    /**
+     * 获取指定 Mesh 范围的组合 bounding box
+     */
+    getMeshRangeBoundingBox(startIndex: number, count: number): BoundingBox | null;
+    /**
+     * 获取整个场景的组合 bounding box
+     */
+    getSceneBoundingBox(): BoundingBox | null;
+    /**
+     * 获取指定索引 Mesh 的材质颜色
+     */
+    getMeshColor(index: number): [number, number, number, number] | null;
+    /**
+     * 设置指定索引 Mesh 的材质颜色
+     */
+    setMeshColor(index: number, r: number, g: number, b: number, a?: number): boolean;
+    /**
+     * 设置指定范围内所有 Mesh 的材质颜色
+     */
+    setMeshRangeColor(startIndex: number, count: number, r: number, g: number, b: number, a?: number): number;
+    /**
+     * 销毁场景管理器
+     */
+    destroy(): void;
+}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@d5techs/3dgs-lib",
+  "version": "1.0.0",
+  "description": "可扩展的 WebGPU 3D 渲染引擎",
+  "type": "module",
+  "main": "./dist/3dgs-lib.cjs",
+  "module": "./dist/3dgs-lib.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/3dgs-lib.js",
+      "require": "./dist/3dgs-lib.cjs",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "keywords": [
+    "webgpu",
+    "3d",
+    "gaussian-splatting",
+    "3dgs",
+    "renderer",
+    "graphics"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": ""
+  },
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build --config vite.lib.config.ts && tsc -p tsconfig.build.json",
+    "build:lib": "vite build --config vite.lib.config.ts && tsc -p tsconfig.build.json",
+    "build:demo": "vite build",
+    "preview": "vite preview",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "@types/node": "^25.2.0",
+    "@vitejs/plugin-basic-ssl": "^2.1.4",
+    "@webgpu/types": "^0.1.40",
+    "fast-check": "^4.5.3",
+    "typescript": "^5.3.3",
+    "vite": "^5.0.10",
+    "vite-plugin-dts": "^4.5.4",
+    "vitest": "^4.0.18"
+  },
+  "peerDependencies": {
+    "@webgpu/types": ">=0.1.40"
+  },
+  "peerDependenciesMeta": {
+    "@webgpu/types": {
+      "optional": true
+    }
+  }
+}