@d5techs/3dgs-lib 1.4.7 → 1.4.9

package/dist/App.d.ts

@@ -205,6 +205,33 @@ export declare class App {
     setAxesVisible(visible: boolean): void;
     getAxesVisible(): boolean;
     getSceneAidsRenderer(): SceneAidsRenderer;
+    /**
+     * 设置渲染缩放比例（影响内部分辨率）
+     * 0.5 = 半分辨率（性能提升约 4 倍），1.0 = 正常
+     * 适用于移动端提质或桌面端降负载
+     */
+    setRenderScale(scale: number): void;
+    getRenderScale(): number;
+    /**
+     * 覆盖自动 DPR，传 -1 恢复自动推荐
+     */
+    setDPR(dpr: number): void;
+    getDPR(): number;
+    /**
+     * 设置桌面端亚像素剔除阈值（默认 1.0）
+     * 值越大剔除越激进，近距离性能越好，但远处细节可能丢失
+     */
+    setPixelCullThreshold(threshold: number): void;
+    /**
+     * 设置桌面端最大可见 splat 数（0 = 不限制）
+     * 限制绘制数量是应对近距离卡顿最直接的手段
+     */
+    setMaxVisibleSplats(count: number): void;
+    /**
+     * 设置排序频率（1 = 每帧，2 = 每两帧，以此类推）
+     * 降低排序频率可提升帧率，代价是移动时短暂排序瑕疵
+     */
+    setSortFrequency(frequency: number): void;
     /**
      * 销毁应用及所有资源
      */

package/dist/core/Renderer.d.ts

@@ -12,6 +12,10 @@ export declare class Renderer {
     private commandEncoder;
     private renderPassEncoder;
     private resizeObserver;
+    private _renderScale;
+    private _customDPR;
+    private _lastCSSWidth;
+    private _lastCSSHeight;
     private _clearColor;
     constructor(canvas: HTMLCanvasElement);
     /**
@@ -46,6 +50,21 @@ export declare class Renderer {
      * 创建深度纹理
      */
     private createDepthTexture;
+    private getEffectiveDPR;
+    /**
+     * 设置渲染缩放比例，用于性能/质量权衡
+     * 0.5 = 半分辨率（性能提升约 4 倍），1.0 = 正常分辨率
+     * 内部等效于降低 DPR，不影响 CSS 布局尺寸
+     */
+    setRenderScale(scale: number): void;
+    getRenderScale(): number;
+    /**
+     * 覆盖自动 DPR 推荐值
+     * 传入 -1 恢复自动模式
+     */
+    setDPR(dpr: number): void;
+    getDPR(): number;
+    private applySize;
     /**
      * 设置 resize 监听
      */

package/dist/core/gizmo/ViewportGizmo.d.ts

@@ -1,83 +1,38 @@
 import { Camera } from "../Camera";
 import { Renderer } from "../Renderer";
 /**
- * ViewportGizmo - 视口坐标轴指示器
- * 在画布右上角显示当前相机朝向
+ * ViewportGizmo - 视口坐标轴指示器（SVG 实现）
+ * 参考 supersplat 的 ViewCube，在画布右上角用 SVG 显示当前相机朝向
  */
 export declare class ViewportGizmo {
-    private renderer;
     private camera;
     private canvas;
-    private pipeline;
-    private uniformBuffer;
-    private bindGroup;
-    private vertexBuffer;
-    private indexBuffer;
-    private vertexCount;
-    private indexCount;
+    private container;
+    private svg;
+    private group;
+    private shapes;
     private size;
     private margin;
-    private projMatrix;
-    private viewMatrix;
-    private axes;
+    private scale;
     private onAxisClick?;
-    constructor(renderer: Renderer, camera: Camera, canvas: HTMLCanvasElement);
-    /**
-     * 设置轴点击回调
-     */
+    private resizeObserver?;
+    constructor(_renderer: Renderer, camera: Camera, canvas: HTMLCanvasElement);
     setOnAxisClick(callback: (axis: string, positive: boolean) => void): void;
+    private createSVG;
+    private createCircle;
+    private createLine;
+    private bindClickEvents;
+    private positionContainer;
+    private setupResizeObserver;
     /**
-     * 创建渲染管线
-     */
-    private createPipeline;
-    /**
-     * 创建 Gizmo 几何体（三个轴 + 箭头）
-     */
-    private createGeometry;
-    /**
-     * 创建圆柱体几何
-     */
-    private createCylinder;
-    /**
-     * 创建圆锥几何
-     */
-    private createCone;
-    /**
-     * 创建球体几何
-     */
-    private createSphere;
-    /**
-     * 创建 uniform buffer
+     * 每帧更新 SVG 位置（从相机视图矩阵中提取轴投影）
      */
-    private createUniformBuffer;
+    render(_pass: GPURenderPassEncoder): void;
     /**
-     * 设置正交投影矩阵
-     */
-    private setupOrthoProjection;
-    /**
-     * 更新 Gizmo 视图矩阵（从相机提取旋转部分）
-     */
-    private updateViewMatrix;
-    /**
-     * 渲染 Gizmo
-     */
-    render(pass: GPURenderPassEncoder): void;
-    /**
-     * 处理点击事件，检测是否点击了某个轴
-     */
-    handleClick(clientX: number, clientY: number): boolean;
-    /**
-     * 检测点击了哪个轴
-     */
-    private detectClickedAxis;
-    private cross;
-    private normalize;
-    /**
-     * 设置 Gizmo 大小
+     * 点击检测 — SVG 版本通过 DOM 事件处理，此方法仅保留接口兼容
      */
+    handleClick(_clientX: number, _clientY: number): boolean;
     setSize(size: number): void;
-    /**
-     * 设置边距
-     */
     setMargin(margin: number): void;
+    destroy(): void;
 }

package/dist/gs/GSSplatRendererMobile.d.ts

@@ -34,6 +34,9 @@ export declare class GSSplatRendererMobile implements IGSSplatRendererWithCapabi
     private cpuPositions;
     private frameCount;
     private sortEveryNFrames;
+    private lastSortViewMatrix;
+    private lastSortProjMatrix;
+    private sortStateInitialized;
     private position;
     private rotation;
     private scaleValue;
@@ -82,13 +85,14 @@ export declare class GSSplatRendererMobile implements IGSSplatRendererWithCapabi
      * 获取当前模型矩阵
      */
     getModelMatrix(): Float32Array;
+    private dummySHTexture;
     /**
      * 创建渲染管线
      */
     private createPipeline;
     /**
      * 创建 uniform buffer
-     * 布局: view (64) + proj (64) + model (64) + cameraPos (12) + pad (4) + screenSize (8) + pad (8) + textureSize (8) + pad (8) = 240 bytes
+     * 布局: view(64) + proj(64) + model(64) + cameraPos(12)+pad(4) + screenSize(8)+pad(8) + textureSize(8)+shEnabled(4)+pad(4) = 240 bytes
      */
     private createUniformBuffer;
     /**
@@ -123,21 +127,10 @@ export declare class GSSplatRendererMobile implements IGSSplatRendererWithCapabi
      * @param n 每 n 帧排序一次
      */
     setSortFrequency(n: number): void;
-    /**
-     * 设置 SH 模式（移动端仅支持 L0）
-     */
-    setSHMode(mode: SHMode): void;
-    /**
-     * 获取当前 SH 模式
-     */
+    private hasCameraChanged;
+    setSHMode(_mode: SHMode): void;
     getSHMode(): SHMode;
-    /**
-     * 是否支持指定的 SH 模式
-     */
     supportsSHMode(mode: SHMode): boolean;
-    /**
-     * 获取渲染器能力
-     */
     getCapabilities(): RendererCapabilities;
     /**
      * 内部销毁资源（不销毁管线）

package/dist/gs/TextureCompressor.d.ts

@@ -28,6 +28,10 @@ export interface CompressedSplatTextures {
     scaleRotTexture1: GPUTexture;
     scaleRotTexture2: GPUTexture;
     colorTexture: GPUTexture;
+    shBasis0Texture: GPUTexture | null;
+    shBasis1Texture: GPUTexture | null;
+    shBasis2Texture: GPUTexture | null;
+    hasSH: boolean;
     boundingBox: {
         min: [number, number, number];
         max: [number, number, number];

package/package.json

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