@d5techs/3dgs-lib 1.4.75 → 1.4.77

package/dist/App.d.ts

@@ -80,6 +80,8 @@ export declare class App {
     private lastAppliedRenderScale;
     private baseRenderScale;
     private boundOnResize;
+    /** 额外渲染回调（在 gizmo 之前、场景辅助之后执行） */
+    private extraRenderCallbacks;
     constructor(canvas: HTMLCanvasElement);
     /**
      * 初始化应用
@@ -210,6 +212,11 @@ export declare class App {
      */
     createSplatBoundingBoxProvider(): SplatBoundingBoxProvider | null;
     getRenderer(): Renderer;
+    /**
+     * 注册额外的渲染回调（在场景辅助之后、gizmo 之前执行）
+     */
+    addRenderCallback(cb: (pass: GPURenderPassEncoder) => void): void;
+    removeRenderCallback(cb: (pass: GPURenderPassEncoder) => void): void;
     /**
      * CPU splat 拾取：在屏幕坐标 (clientX, clientY) 处找最近的 splat，返回世界坐标或 null
      */

package/dist/editor/SelectionVolumeRenderer.d.ts

@@ -0,0 +1,32 @@
+import { Renderer } from "../core/Renderer";
+import { Camera } from "../core/Camera";
+export type VolumeType = 'box' | 'sphere' | null;
+export interface VolumeState {
+    type: VolumeType;
+    center: [number, number, number];
+    /** box: [lenX, lenY, lenZ]; sphere: [radius, 0, 0] */
+    dimensions: [number, number, number];
+}
+export declare class SelectionVolumeRenderer {
+    private renderer;
+    private camera;
+    private pipeline;
+    private uniformBuffer;
+    private bindGroup;
+    private vertexBuffer;
+    private _volume;
+    private vertexCount;
+    private maxVertices;
+    private lineColor;
+    constructor(renderer: Renderer, camera: Camera);
+    get volume(): VolumeState;
+    setVolume(type: VolumeType, center?: [number, number, number], dimensions?: [number, number, number]): void;
+    setCenter(x: number, y: number, z: number): void;
+    setDimensions(a: number, b: number, c: number): void;
+    private createPipeline;
+    private createVertexBuffer;
+    private generateBoxVertices;
+    private generateSphereVertices;
+    render(pass: GPURenderPassEncoder): void;
+    destroy(): void;
+}

package/dist/editor/SplatEditor.d.ts

@@ -5,20 +5,29 @@
  * 将 splat 中心投影到屏幕空间来判断哪些 splat 在选区内。
  */
 import type { Camera } from '../core/Camera';
+import type { Renderer } from '../core/Renderer';
+import type { TransformableObject } from '../core/gizmo/TransformGizmo';
 import type { GSSplatRenderer } from '../gs/GSSplatRenderer';
 import type { CompactSplatData } from '../gs/PLYLoaderMobile';
 import { SplatState } from './SplatState';
 import { EditHistory } from './EditHistory';
 import { ToolManager } from './tools/ToolManager';
+import { SelectionVolumeRenderer } from './SelectionVolumeRenderer';
+import type { VolumeState } from './SelectionVolumeRenderer';
 export interface SplatEditorCallbacks {
     onStateChanged?: () => void;
     onToolChanged?: (tool: string | null) => void;
     onHistoryChanged?: (canUndo: boolean, canRedo: boolean) => void;
     /** 退出编辑模式时调用，传回精简后的 CompactSplatData（已剔除删除的 splat） */
     onApplyEdits?: (newData: CompactSplatData) => void;
+    /** 体积选择工具激活时调用（返回当前 volume state） */
+    onVolumeToolActivated?: (volume: VolumeState) => void;
+    /** 体积选择工具停用时调用 */
+    onVolumeToolDeactivated?: () => void;
 }
 export declare class SplatEditor {
     private camera;
+    private gpuRenderer;
     private gsRenderer;
     private container;
     private splatState;
@@ -33,7 +42,11 @@ export declare class SplatEditor {
     private projDirty;
     private _active;
     private overlayCleanup;
-    constructor(camera: Camera, gsRenderer: GSSplatRenderer, container: HTMLElement, callbacks?: SplatEditorCallbacks);
+    /** 体积选择线框渲染器 */
+    volumeRenderer: SelectionVolumeRenderer | null;
+    private boxTool;
+    private sphereTool;
+    constructor(camera: Camera, gsRenderer: GSSplatRenderer, container: HTMLElement, callbacks?: SplatEditorCallbacks, renderer?: Renderer);
     get active(): boolean;
     get state(): SplatState;
     get history(): EditHistory;
@@ -46,6 +59,10 @@ export declare class SplatEditor {
      * 进入编辑模式
      */
     enter(): void;
+    /**
+     * 渲染体积选择线框（在主渲染 pass 内调用）
+     */
+    renderVolume(pass: GPURenderPassEncoder): void;
     /**
      * 退出编辑模式，将编辑结果永久写入渲染数据
      */
@@ -71,13 +88,34 @@ export declare class SplatEditor {
     private selectByMask;
     private selectByColor;
     /**
-     * 球选择：在屏幕空间判断 splat 是否在圆形区域内
+     * 世界空间球体选择
+     */
+    selectByWorldSphere(op: 'add' | 'remove' | 'set', center: [number, number, number], radius: number): void;
+    /**
+     * 世界空间 AABB 选择
+     */
+    selectByWorldBox(op: 'add' | 'remove' | 'set', center: [number, number, number], lenX: number, lenY: number, lenZ: number): void;
+    /**
+     * 应用当前体积选择
+     */
+    applyVolumeSelection(op: 'add' | 'remove' | 'set'): void;
+    /**
+     * 设置体积选择的中心位置（供外部 gizmo 调用）
+     */
+    setVolumeCenter(x: number, y: number, z: number): void;
+    /**
+     * 获取当前体积状态
+     */
+    getVolumeState(): VolumeState | null;
+    /**
+     * 创建体积位置的 TransformableObject 代理，供 gizmo 控制
      */
-    private selectBySphere;
+    createVolumeTransformProxy(): TransformableObject | null;
     /**
-     * 盒选择：在屏幕空间判断 splat 是否在矩形区域内
+     * 获取模型世界空间包围盒（中心 + 尺寸）
      */
-    private selectByBox;
+    private getModelBounds;
+    private getModelCenter;
     /**
      * 根据屏幕像素坐标，找到最近的可见 splat 并返回其世界坐标及深度换算系数
      */

package/dist/editor/index.d.ts

@@ -5,3 +5,5 @@ export { EditHistory } from './EditHistory';
 export { ToolManager } from './tools/ToolManager';
 export type { Tool } from './tools/ToolManager';
 export { exportEditedPLY } from './SplatExporter';
+export { SelectionVolumeRenderer } from './SelectionVolumeRenderer';
+export type { VolumeType, VolumeState } from './SelectionVolumeRenderer';

package/dist/editor/tools/BoxSelection.d.ts

@@ -1,24 +1,24 @@
 import type { Tool } from './ToolManager';
+export interface BoxSelectionCallbacks {
+    onApply: (op: 'add' | 'remove' | 'set') => void;
+    onDimensionsChanged: (lenX: number, lenY: number, lenZ: number) => void;
+}
 export declare class BoxSelection implements Tool {
     private parent;
-    private svg;
-    private rect;
-    private crossV;
-    private crossH;
-    private onSelect;
-    private center;
-    private halfW;
-    private halfH;
-    private dragId;
-    constructor(parent: HTMLElement, onSelect: (op: 'add' | 'remove' | 'set', centerPx: {
-        x: number;
-        y: number;
-    }, halfW: number, halfH: number) => void);
+    private toolbar;
+    private callbacks;
+    private _lenX;
+    private _lenY;
+    private _lenZ;
+    private inputX;
+    private inputY;
+    private inputZ;
+    get lenX(): number;
+    get lenY(): number;
+    get lenZ(): number;
+    constructor(parent: HTMLElement, callbacks: BoxSelectionCallbacks);
+    setDimensions(lenX: number, lenY: number, lenZ: number): void;
     activate(): void;
     deactivate(): void;
-    private updateVisuals;
-    private pointerdown;
-    private pointermove;
-    private dragEnd;
-    private pointerup;
+    private emitDims;
 }

package/dist/editor/tools/SphereSelection.d.ts

@@ -1,21 +1,17 @@
 import type { Tool } from './ToolManager';
+export interface SphereSelectionCallbacks {
+    onApply: (op: 'add' | 'remove' | 'set') => void;
+    onRadiusChanged: (radius: number) => void;
+}
 export declare class SphereSelection implements Tool {
     private parent;
-    private svg;
-    private circle;
-    private onSelect;
-    private center;
-    private radiusPx;
-    private dragId;
-    constructor(parent: HTMLElement, onSelect: (op: 'add' | 'remove' | 'set', centerPx: {
-        x: number;
-        y: number;
-    }, radiusPx: number) => void);
+    private toolbar;
+    private callbacks;
+    private _radius;
+    private radiusInput;
+    get radius(): number;
+    constructor(parent: HTMLElement, callbacks: SphereSelectionCallbacks);
+    setRadius(radius: number): void;
     activate(): void;
     deactivate(): void;
-    private updateCircle;
-    private pointerdown;
-    private pointermove;
-    private dragEnd;
-    private pointerup;
 }

package/dist/index.d.ts

@@ -55,5 +55,7 @@ export { EditHistory } from './editor/EditHistory';
 export { ToolManager } from './editor/tools/ToolManager';
 export type { Tool } from './editor/tools/ToolManager';
 export { exportEditedPLY } from './editor/SplatExporter';
+export { SelectionVolumeRenderer } from './editor/SelectionVolumeRenderer';
+export type { VolumeType, VolumeState } from './editor/SelectionVolumeRenderer';
 export { App } from './App';
 export type { ProgressCallback, AdaptivePerformanceConfig } from './App';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@d5techs/3dgs-lib",
-  "version": "1.4.75",
+  "version": "1.4.77",
   "description": "可扩展的 WebGPU 3D 渲染引擎",
   "type": "module",
   "main": "./dist/3dgs-lib.cjs",