iflow-engine-base 3.9.205 → 3.9.222

package/dist/chunks/{three-vendor-Dbcwwhki.js → three-vendor-Drr85AIk.js}

@@ -43353,7 +43353,7 @@ Mi.add.bind(Mi);
 Mi.remove.bind(Mi);
 Mi.update.bind(Mi);
 export {
-  Oh as $,
+  U1 as $,
   yv as A,
   Ve as B,
   Ae as C,
@@ -43361,10 +43361,10 @@ export {
   Dn as E,
   Me as F,
   Wi as G,
-  Nt as H,
+  Wt as H,
   _d as I,
-  ht as J,
-  F1 as K,
+  Nt as J,
+  ht as K,
   ln as L,
   Se as M,
   X1 as N,
@@ -43374,76 +43374,78 @@ export {
   b0 as R,
   li as S,
   r0 as T,
-  N1 as U,
+  Xt as U,
   T as V,
   bI as W,
-  Gi as X,
-  tr as Y,
-  U1 as Z,
-  O1 as _,
+  F1 as X,
+  N1 as Y,
+  Gi as Z,
+  tr as _,
   pd as a,
-  tc as a0,
-  Q1 as a1,
-  xr as a2,
-  k1 as a3,
-  oi as a4,
-  kd as a5,
-  o0 as a6,
-  Wn as a7,
-  Tf as a8,
-  G1 as a9,
-  kn as aA,
-  Cn as aB,
-  Eh as aC,
-  Kn as aD,
-  Tt as aE,
-  qe as aF,
-  yt as aG,
-  Yo as aH,
-  I0 as aI,
-  Es as aJ,
-  Si as aK,
-  Fl as aL,
-  Ll as aM,
-  hh as aN,
-  ec as aO,
-  Vb as aP,
-  h0 as aQ,
-  xx as aR,
-  cr as aS,
-  Ht as aT,
-  Ms as aU,
-  Je as aV,
-  ro as aW,
-  vo as aX,
-  j1 as aY,
-  q1 as aZ,
-  Km as aa,
-  Rt as ab,
-  Im as ac,
-  k_ as ad,
-  bd as ae,
-  Rn as af,
-  V1 as ag,
-  hi as ah,
-  H1 as ai,
-  po as aj,
-  zf as ak,
-  ph as al,
-  Ra as am,
-  on as an,
-  Kd as ao,
-  at as ap,
-  z1 as aq,
-  W1 as ar,
-  r1 as as,
-  Mg as at,
-  iv as au,
-  D1 as av,
-  vd as aw,
-  ws as ax,
-  qt as ay,
-  Bt as az,
+  q1 as a$,
+  O1 as a0,
+  Oh as a1,
+  tc as a2,
+  Q1 as a3,
+  xr as a4,
+  k1 as a5,
+  oi as a6,
+  kd as a7,
+  o0 as a8,
+  on as a9,
+  qt as aA,
+  Bt as aB,
+  kn as aC,
+  Cn as aD,
+  Eh as aE,
+  Kn as aF,
+  Tt as aG,
+  qe as aH,
+  yt as aI,
+  Yo as aJ,
+  I0 as aK,
+  Es as aL,
+  Si as aM,
+  Fl as aN,
+  Ll as aO,
+  hh as aP,
+  ec as aQ,
+  Vb as aR,
+  h0 as aS,
+  xx as aT,
+  cr as aU,
+  Ht as aV,
+  Ms as aW,
+  Je as aX,
+  ro as aY,
+  vo as aZ,
+  j1 as a_,
+  Wn as aa,
+  Tf as ab,
+  G1 as ac,
+  Km as ad,
+  Rt as ae,
+  Im as af,
+  k_ as ag,
+  bd as ah,
+  Rn as ai,
+  V1 as aj,
+  hi as ak,
+  H1 as al,
+  po as am,
+  zf as an,
+  ph as ao,
+  Ra as ap,
+  Kd as aq,
+  mh as ar,
+  at as as,
+  z1 as at,
+  W1 as au,
+  r1 as av,
+  Mg as aw,
+  iv as ax,
+  vd as ay,
+  ws as az,
   Y as b,
   zh as c,
   fr as d,
@@ -43458,15 +43460,15 @@ export {
   P1 as m,
   Cm as n,
   sn as o,
-  Ii as p,
-  vt as q,
-  ot as r,
-  Vt as s,
-  y0 as t,
-  Hb as u,
-  nv as v,
-  L1 as w,
-  Yy as x,
-  nw as y,
-  Wt as z
+  D1 as p,
+  Ii as q,
+  vt as r,
+  ot as s,
+  Vt as t,
+  y0 as u,
+  Hb as v,
+  nv as w,
+  L1 as x,
+  Yy as y,
+  nw as z
 };

package/dist/index.d.ts

@@ -4096,6 +4096,10 @@ declare interface LevelLocationResult {
     isInside: boolean;
 }
 
+/**
+ * 管理场景基础光照和动态阴影相机范围。
+ * 主要职责是创建环境光、补光、投影灯，并随视图和模型范围更新阴影覆盖区域。
+ */
 declare class LightModule {
     private engine;
     private lastShadowHalfSize;
@@ -4103,24 +4107,133 @@ declare class LightModule {
     private lastShadowFar;
     private lastLightPosition;
     private lastLightTarget;
+    private lastShadowIntensity;
+    private shadowCasterPolicyChecked;
+    private lastShadowCasterPolicySceneSize;
+    /**
+     * 创建光照模块。
+     * @param engine BIM 引擎实例，内部会从中读取 scene、controls、octreeBox 等对象。
+     */
     constructor(engine: any);
-    /** 初始化场景基础光照，并保留投影灯的稳定引用。 */
+    /**
+     * 初始化场景基础光照，并把投影灯引用挂到 scene 上供后续更新使用。
+     */
     init(): void;
-    /** 兼容旧调用名：更新定向光阴影的有效覆盖范围。 */
+    /**
+     * 兼容旧调用名：更新定向光阴影的有效覆盖范围。
+     * @param camera 当前渲染相机；传 null 时只按场景范围或默认值更新。
+     */
     updateShadowCameraRange(camera: THREE.Camera | null): void;
-    /** 根据当前视图和模型范围移动投影灯、target 与阴影相机。 */
+    /**
+     * 根据当前视图和模型范围移动投影灯、target 与阴影相机。
+     * @param camera 当前渲染相机，用于估算屏幕可视范围；传 null 时退回到场景范围。
+     */
     updateDirectionalShadow(camera: THREE.Camera | null): void;
+    /**
+     * 计算场景范围对阴影相机半边长的贡献。
+     * @param sceneHalfExtent 场景包围盒最大边的一半，单位为世界坐标。
+     * @param cameraHalfExtent 当前相机可视范围最大半边长，单位为世界坐标。
+     * @returns 阴影相机应考虑的场景半边长。
+     */
     private getSceneShadowHalfSize;
+    /**
+     * 根据阴影相机范围动态调整 bias，平衡阴影条纹和阴影悬浮。
+     * @param light 负责投影的定向光。
+     * @param shadowHalfSize 阴影正交相机半边长，单位为世界坐标。
+     * @param shadowDepthRange 阴影相机深度范围。
+     */
     private updateShadowBias;
+    /**
+     * 计算阴影相机沿光照方向的 near/far 范围。
+     * @param sceneBox 当前场景包围盒；为 null 时使用兜底范围。
+     * @param lightPosition 投影灯世界坐标。
+     * @param target 投影灯 target 世界坐标。
+     * @param sceneDepth 场景包围盒对角线长度，用于兜底 far 估算。
+     * @param shadowHalfSize 阴影相机半边长，用于兜底 far 估算。
+     * @returns 阴影相机深度范围。
+     */
     private getShadowDepthRange;
+    /**
+     * 获取包围盒 8 个顶点。
+     * @param box 需要拆分顶点的 three.js 包围盒。
+     * @returns 包围盒所有角点的世界坐标数组。
+     */
     private getBoxCorners;
+    /**
+     * 从场景中找到当前负责投影的定向光。
+     * @returns 可投影的 DirectionalLight；找不到时返回 null。
+     */
     private getShadowDirectionalLight;
+    /**
+     * 获取当前场景的有效包围盒。
+     * @returns 有效模型包围盒；场景为空或范围异常时返回 null。
+     */
     private getSceneBoundingBox;
+    /**
+     * 规范化包围盒最小点和最大点，兼容 min/max 顺序被反转的输入。
+     * @param min 原始最小点。
+     * @param max 原始最大点。
+     * @returns 规范化后的包围盒；坐标非法或范围异常时返回 null。
+     */
     private normalizeBox;
+    /**
+     * 校验包围盒是否可用于阴影计算。
+     * @param box 候选包围盒。
+     * @returns 有效包围盒；过小、过大或异常时返回 null。
+     */
     private validateBox;
+    /**
+     * 估算当前相机视图在目标点附近需要覆盖的半边长。
+     * @param camera 当前渲染相机。
+     * @param fallbackTarget 没有 controls.target 时用于估算距离的目标点。
+     * @returns 相机视图最大半边长；没有有效相机时返回 0。
+     */
     private getCameraHalfExtent;
+    /**
+     * 解析阴影应跟随的目标点。
+     * @param camera 当前渲染相机。
+     * @param fallbackTarget 优先级低于 controls.target 的兜底目标点。
+     * @returns 用于定位投影灯 target 的世界坐标。
+     */
     private resolveShadowTarget;
+    /**
+     * 获取投影灯相对 target 的方向。
+     * @returns 标准化后的世界空间光源偏移方向。
+     */
     private getLightOffsetDirection;
+    /**
+     * 根据当前视角和阴影贴图密度计算最终显示强度。
+     * @param camera 当前渲染相机。
+     * @param lightDirection 投影灯相对 target 的方向。
+     * @param shadowHalfSize 阴影正交相机半边长。
+     * @param mapWidth 阴影贴图宽度。
+     * @returns 本帧应使用的阴影强度。
+     */
+    private getShadowDisplayIntensity;
+    /**
+     * 把阴影 target 对齐到阴影贴图 texel 网格。
+     * @param target 原始阴影目标点。
+     * @param lightDirection 投影灯相对 target 的方向。
+     * @param shadowHalfSize 阴影正交相机半边长。
+     * @param mapWidth 阴影贴图宽度。
+     * @returns 对齐后的 target，减少相机远距离移动时的阴影采样抖动和规则纹理。
+     */
+    private snapShadowTargetToTexel;
+    /**
+     * 自动降低大面积薄片构件的投影风险。
+     * @param sceneBox 当前场景包围盒，用于判断场景尺寸是否变化。
+     */
+    private updateShadowCasterPolicy;
+    /**
+     * 对单个 mesh 应用投影策略。
+     * @param mesh 候选投影对象。
+     */
+    private applyShadowCasterPolicy;
+    /**
+     * 对仍参与投影的实体使用背面写入阴影，降低封闭体表面的自投影条纹。
+     * @param material mesh 材质或材质数组。
+     */
+    private setBackSideShadowCasting;
 }
 
 /**
@@ -4192,9 +4305,59 @@ declare interface LoaderModel2d {
 }
 
 declare class LoaderModule {
+    private static localRequestMap;
+    private static localObjectUrls;
+    private static interceptorInstalled;
     private engine;
     constructor(engine: any);
+    /**
+     * 批量加载模型 URL。
+     */
     loadModels(urls: string[], options?: LoadModelOptions): Promise<void>;
+    /**
+     * 直接加载用户在浏览器中选择的本地模型文件。
+     * 支持两种输入：
+     * 1. 直接选择 `info / property / edge / lod0...` 这组模型包文件。
+     * 2. 选择一个外层 zip，zip 内部包含上述模型包文件或解压后的同名目录。
+     */
+    loadModelFile(files: File[], options?: LoadModelOptions): Promise<void>;
+    /**
+     * 把浏览器 File 列表整理成现有加载器可识别的本地虚拟模型入口。
+     */
+    private buildLocalModelEntries;
+    /**
+     * 展开输入文件。
+     * 已经是模型包文件时直接保留；仅把“外层容器 zip”解包成内部条目。
+     */
+    private collectSourceEntries;
+    /**
+     * 识别已经打好的模型包文件，例如 `info`、`lod0.zip`。
+     */
+    private parseDirectPackageEntry;
+    /**
+     * 识别解压后的模型目录，例如 `lod0/nodes.json`、`info/info.json`。
+     */
+    private parseExtractedPackageEntry;
+    /**
+     * 把解压目录重新打包成 zip Blob，复用现有按包加载的实现。
+     */
+    private packEntriesAsZip;
+    /**
+     * 注册 axios 拦截器，把虚拟模型地址改写为对应的 Blob URL。
+     */
+    private static ensureLocalRequestInterceptor;
+    /**
+     * 为某个虚拟请求地址生成 Blob URL 映射。
+     */
+    private static registerLocalRequest;
+    /**
+     * 统一规范虚拟请求 key，兼容传入绝对地址或带 query 的地址。
+     */
+    private static normalizeRequestKey;
+    /**
+     * 生成稳定且不会冲突的本地模型虚拟 ID。
+     */
+    private static createLocalModelId;
 }
 
 declare class LoaderModule2d {
@@ -5844,9 +6007,14 @@ declare type RenderMode = 'simple' | 'balance' | 'advanced';
 declare class RenderModule {
     private engine;
     renderer: THREE_2.WebGLRenderer | null;
+    private watermark;
     constructor(engine: any);
     createRenderer(): any;
     disposeRenderer(): void;
+    /**
+     * 在最终渲染结果上追加 canvas 内嵌水印。
+     */
+    drawWatermark(): void;
 }
 
 declare class RenderModule2d {
@@ -5854,6 +6022,7 @@ declare class RenderModule2d {
     renderer: THREE.WebGLRenderer;
     private container;
     private options;
+    private watermark;
     private antialias;
     private alpha;
     private precision;
@@ -5917,6 +6086,10 @@ declare class RenderModule2d {
      * @param stencil 是否清除模板缓冲
      */
     clear(color?: boolean, depth?: boolean, stencil?: boolean): void;
+    /**
+     * 将水印绘制到当前 WebGL canvas，供主循环和截图的强制渲染复用。
+     */
+    drawWatermark(): void;
     /**
      * 获取渲染器信息
      * @returns 渲染器信息
@@ -5941,6 +6114,7 @@ declare class RenderModule720 {
     private container;
     private animationId;
     private isRenderingPaused;
+    private watermark;
     private fpsFrameCount;
     private fpsLastTime;
     private currentFps;
@@ -6030,6 +6204,7 @@ declare class RenderModuleGaussian {
     private fpsFrameCount;
     private fpsLastTime;
     private fpsInfo;
+    private watermark;
     private onBeforeRenderCallback?;
     private onAfterRenderCallback?;
     private onFpsUpdatedCallback?;