@d5techs/3dgs-lib 1.4.44 → 1.4.46

package/dist/App.d.ts

@@ -187,6 +187,7 @@ export declare class App {
     }): Promise<void>;
     clearSkybox(): void;
     isSkyboxActive(): boolean;
+    setSkyboxAlignToGround(value: boolean): void;
     getTransformGizmo(): import(".").TransformGizmo;
     getViewportGizmo(): import(".").ViewportGizmo;
     setViewportGizmoVisible(visible: boolean): void;

package/dist/core/OrbitControls.d.ts

@@ -81,6 +81,8 @@ export declare class OrbitControls {
      * 将球坐标写入相机位置（内部方法，不处理阻尼）
      */
     private applySpherical;
+    get modelCenter(): [number, number, number];
+    get modelRadius(): number;
     /**
      * 旋转速度缩放：当 target 远离模型时降低旋转灵敏度，
      * 使模型在屏幕上的视觉运动速度保持一致。

package/dist/core/SkyboxRenderer.d.ts

@@ -8,14 +8,16 @@ export declare class SkyboxRenderer {
     private cubeTexture;
     private cubeBindGroup;
     private frameReady;
+    alignToGround: boolean;
     constructor(device: GPUDevice, format: GPUTextureFormat, depthFormat: GPUTextureFormat);
     get isActive(): boolean;
     loadCubemap(faceUrls: [string, string, string, string, string, string]): Promise<void>;
     /**
-     * Write uniforms BEFORE beginFrame(). No matrix inversion needed —
-     * we extract the view rotation transpose and inverse projection scalars directly.
+     * Write uniforms BEFORE beginFrame().
+     * pitchOffset: radians to rotate sampling direction around world X axis,
+     * used to align skybox horizon with model ground plane.
      */
-    prepareFrame(viewMatrix: Float32Array, projectionMatrix: Float32Array): void;
+    prepareFrame(viewMatrix: Float32Array, projectionMatrix: Float32Array, pitchOffset?: number): void;
     draw(pass: GPURenderPassEncoder): void;
     clear(): void;
     destroy(): void;

package/package.json

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