@belife/belife-bim-air 2.3.13-patch.2 → 2.3.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@belife/belife-bim-air",
3
- "version": "2.3.13-patch.2",
3
+ "version": "2.3.14",
4
4
  "description": "发布的基于gs-longan的图形显示控件",
5
5
  "main": "lib/BimAir.umd.min.js",
6
6
  "types": "./types/bimAir/src/index.d.ts",
@@ -168,6 +168,11 @@ export default class RenderObjectManager extends ViewerManagerBase implements IU
168
168
  * @param visible 模型是否允许显示边框
169
169
  */
170
170
  setLightModelBorderVisible(modelId: string, visible: boolean): void;
171
+ /**
172
+ * @internal 整模型卸载后释放其线框登记与显隐覆盖,避免同 ID 重载继承旧隐藏状态。
173
+ * 网格资源由模型自身释放;HLOD 分块切换不能调用此方法,仍需保留模型级显隐。
174
+ */
175
+ disposeModelBorderState(modelId: string): void;
171
176
  /**
172
177
  * 按需加载单个 HLOD 节点的 border,并复用同一节点的在途任务。
173
178
  */
@@ -322,6 +322,11 @@ export declare class StyleManager extends ViewerManagerBase {
322
322
  * @param value TreeNodeObject数组
323
323
  */
324
324
  setRender(isRender: boolean, value: TreeNodeObject | TreeNodeObject[]): void;
325
+ /**
326
+ * 递归应用实体显隐,并同步遍历到的真实模型根节点,覆盖项目/业务分组包含模型的情况。
327
+ * 线框仍受全局开关控制;尚无构件归属映射,不能用普通子节点切换整模型线框。
328
+ */
329
+ protected setTreeNodesVisible(nodes: TreeNodeObject[], visible: boolean): void;
325
330
  /**
326
331
  * @description 节点隐藏
327
332
  * @param value TreeNodeObject数组
@@ -17,6 +17,8 @@ export declare class CuttingBoxOperator extends ViewerOperator {
17
17
  _selectedShell: Shell;
18
18
  _downPos: Vector3;
19
19
  _prePos: Vector3;
20
+ private _dragNormal;
21
+ private _dragBox;
20
22
  _boxVisible: boolean;
21
23
  logarithmicDepthBuffer: any;
22
24
  get CuttingBox(): CuttingBoxObject;
@@ -0,0 +1,8 @@
1
+ import { Vector3, ViewerEvent } from "gs-longan";
2
+ /**
3
+ * 将鼠标射线投影到固定拖动轴。近乎平行时没有稳定解,保留上一帧状态,避免无穷位移或方向翻转。
4
+ * 使用射线原点而非动态拾取点,拖出手柄、穿过模型表面后仍沿同一轴移动。
5
+ */
6
+ export declare function projectCuttingAxis(event: ViewerEvent, origin: Vector3, direction: Vector3): Vector3 | null;
7
+ /** 平面旋转只接收相机前方的稳定交点;射线平行或交点位于相机后方时跳过该帧。 */
8
+ export declare function projectCuttingPlane(event: ViewerEvent, origin: Vector3, normal: Vector3): Vector3 | null;
@@ -94,6 +94,8 @@ export interface ViewerOptions {
94
94
  components?: {
95
95
  /** 加载弹框配置 */
96
96
  loading?: {
97
+ /** 是否启用内置 Loading,默认 true;false 时由业务维护加载提示 */
98
+ enabled?: boolean;
97
99
  /** 加载弹框的可见性 */
98
100
  visible?: boolean;
99
101
  /** 加载弹框颜色 */
@@ -1,51 +1,36 @@
1
1
  import Effect, { EffectInterface } from "../effect";
2
- import { PostProcess, ShaderLanguage } from "../../../../../longan/src";
2
+ import { PostProcess, ShaderLanguage } from "gs-longan";
3
3
  import { Viewer } from "../../../gsDevFx/viewer";
4
4
  export interface EmissiveEffectOption extends EffectInterface {
5
5
  id?: string;
6
6
  name: string;
7
- /** 发光效果 */
8
7
  type: "emissive";
9
8
  options: {
10
- /** 颜色 */
9
+ /** RGB 颜色,分量范围 0–255。 */
11
10
  color?: number[];
12
- /** 半径 */
11
+ /** 光晕模糊半径,单位像素。 */
13
12
  radius?: number;
14
- /** 强度 */
13
+ /** 光晕强度倍率。 */
15
14
  strength?: number;
16
15
  };
17
16
  }
18
17
  export default class EmissiveEffect extends Effect {
19
18
  options: EmissiveEffectOption["options"];
20
- private scene;
21
19
  private glow;
22
- /** 生成器使用的着色器语言 */
20
+ private styleObserver;
21
+ private originalColors;
22
+ private includedMeshes;
23
+ private selectedSubMeshes;
24
+ private disposed;
23
25
  protected _shaderLanguage: ShaderLanguage;
24
26
  brightPostProcess: PostProcess;
25
- /**
26
- * 获取此生成器中使用的着色器语言。
27
- */
28
27
  get shaderLanguage(): ShaderLanguage;
29
- /**
30
- * 根据配置信息创建
31
- * @param emissiveEffectOptions
32
- */
33
28
  constructor(viewer: Viewer);
34
- fromJson(effectOption: EmissiveEffectOption): void;
35
- /**
36
- * 处理创建:创建glowlayer、color3,更新场景、glow、blurkernelsize,调用设置keep分离、更新全部样式,并同步自发光特效的最终状态。
37
- * @returns 自发光特效完成后的异步结果
38
- */
29
+ /** 等待构件材质分离后绑定实际子网格;样式重建时重新绑定,避免旧材质引用失效。 */
39
30
  create(): Promise<this>;
40
- /**
41
- * 隐藏当前面板,并清理面板的临时交互状态。
42
- * @returns
43
- */
31
+ private restoreMaterials;
32
+ private bindSubMeshes;
44
33
  hide(): void;
45
- /**
46
- * 显示当前面板,并将查看器数据同步到面板组件。
47
- * @returns
48
- */
49
34
  show(): void;
50
35
  dispose(): void;
51
36
  }
@@ -1,4 +1,5 @@
1
1
  import { Viewer } from "../../../gsDevFx/viewer";
2
+ import { ParticleSystemSet } from "../../../../../longan/src/core";
2
3
  import Effect, { EffectInterface } from "../effect";
3
4
  export interface RainEffectOption extends EffectInterface {
4
5
  name: string;
@@ -7,7 +8,7 @@ export interface RainEffectOption extends EffectInterface {
7
8
  }
8
9
  export default class RainEffect extends Effect {
9
10
  viewer: Viewer;
10
- particleSystemSet: any;
11
+ particleSystemSet: ParticleSystemSet;
11
12
  constructor(viewer: any);
12
13
  fromJson(effectOption: RainEffectOption): void;
13
14
  /**
@@ -7,22 +7,22 @@ export interface AtmEffectOption extends EffectInterface {
7
7
  export default class AtmEffect extends Effect {
8
8
  private _skyBox;
9
9
  private _atmComponent;
10
+ private _directionalLight;
11
+ private _lightDirection;
10
12
  constructor(viewer: any);
11
13
  fromJson(effectOption: AtmEffectOption): void;
12
14
  /**
13
- * 处理创建:创建atmosphericscattering构件、vector3,更新atm构件、direction,调用创建、查找,并同步atm特效的最终状态。
14
- * @returns atm特效完成后的异步结果
15
+ * 准备大气组件,主光方向仅在显示期间临时覆盖,未显示的效果不改变场景光照。
16
+ * @returns 完成组件准备的效果实例。
15
17
  */
16
18
  create(): Promise<this>;
17
19
  dispose(): void;
18
20
  /**
19
- * 显示当前面板,并将查看器数据同步到面板组件。
20
- * @returns
21
+ * 显示大气并临时应用太阳方向;关闭时恢复其他活动天空效果或原光照方向。
21
22
  */
22
23
  show(): void;
23
24
  /**
24
- * 隐藏当前面板,并清理面板的临时交互状态。
25
- * @returns
25
+ * 隐藏大气并释放临时主光方向;重复隐藏或销毁不会再次改动光照。
26
26
  */
27
27
  hide(): void;
28
28
  /**
@@ -0,0 +1,8 @@
1
+ import { DirectionalLightComponent, Vector3 } from "gs-longan";
2
+ /**
3
+ * 天空效果临时借用主光方向;最后显示的效果优先,重复更新同一效果不会改变覆盖顺序。
4
+ * 光晕与大气共享此状态,避免交错关闭时恢复到另一个已关闭效果的方向。
5
+ */
6
+ export declare function applySkyboxLightDirection(light: DirectionalLightComponent, owner: object, direction: Vector3): void;
7
+ /** 释放当前效果的方向覆盖;没有其他天空效果时恢复借用前的方向。 */
8
+ export declare function releaseSkyboxLightDirection(light: DirectionalLightComponent, owner: object): void;
@@ -6,7 +6,7 @@ export interface SunEffectOption extends EffectInterface {
6
6
  }
7
7
  export default class SunEffect extends Effect {
8
8
  private sunComponent;
9
- private originalLightDirection;
9
+ private directionalLight;
10
10
  constructor(viewer: any);
11
11
  fromJson(effectOption: SunEffectOption): void;
12
12
  /**
@@ -15,14 +15,15 @@ export default class SunEffect extends Effect {
15
15
  */
16
16
  create(): Promise<this>;
17
17
  /**
18
- * 显示当前面板,并将查看器数据同步到面板组件。
18
+ * 显示太阳与光晕,并临时借用主光方向;与大气散射共享覆盖顺序。
19
19
  * @returns
20
20
  */
21
21
  show(): void;
22
22
  /**
23
- * 隐藏当前面板,并清理面板的临时交互状态。
23
+ * 隐藏太阳与光晕,释放方向覆盖以恢复其他天空效果或原光照。
24
24
  * @returns
25
25
  */
26
26
  hide(): void;
27
+ dispose(): void;
27
28
  setIntensity(value: number): void;
28
29
  }
@@ -37,7 +37,7 @@ export default class VideoEffect extends Effect {
37
37
  * @returns 视频特效完成后的异步结果
38
38
  */
39
39
  create(): Promise<this>;
40
- play(): void;
40
+ play(): Promise<void>;
41
41
  pause(): void;
42
42
  /**
43
43
  * 显示当前面板,并将查看器数据同步到面板组件。
@@ -19,8 +19,8 @@ export default class ViewPointPanel extends Panel {
19
19
  private generateViewPointObjectList;
20
20
  private saveImage;
21
21
  /**
22
- * 获取当前视点图片
23
- * @returns 图片Blob数据
22
+ * 请求重绘并截取完成帧,叠加当前 SVG 标注,返回 PNG Data URL。
23
+ * 不等待模型加载;调用方需先确认所需模型已就绪。
24
24
  */
25
25
  getImage(width?: number, height?: number, quality?: number): Promise<string>;
26
26
  /**
@@ -7,6 +7,8 @@ import { Viewer } from "../gsDevFx/viewer";
7
7
  import "../plugins/element";
8
8
  export default class ViewerWrapper extends Vue {
9
9
  elementId: any;
10
+ /** Viewer 绑定前的 Loading 策略,需与创建 Viewer 时使用的配置保持一致。 */
11
+ viewerOptions?: ViewerOptions;
10
12
  private viewerResizeObserver;
11
13
  private viewerResizeFrame;
12
14
  private viewerSearchTimer;
@@ -17,7 +19,6 @@ export default class ViewerWrapper extends Vue {
17
19
  static modelLoadedCount: number;
18
20
  modelName: string;
19
21
  mapVisible: boolean;
20
- privateIsShowLoading: boolean;
21
22
  viewModel: Longan.ViewModel;
22
23
  store: import("vuex").Store<{
23
24
  treeData: any[];
@@ -35,8 +36,8 @@ export default class ViewerWrapper extends Vue {
35
36
  }>;
36
37
  options: ViewerOptions;
37
38
  loadingSrc: string;
38
- onOptionsIsShowLoadingChanged(val: boolean): void;
39
- onLoadingVisibleChanged(val: boolean): void;
39
+ /** 禁用只抑制内置遮罩,不改写引擎操作维护的加载请求状态。 */
40
+ get privateIsShowLoading(): boolean;
40
41
  currentLoaded: number;
41
42
  currentToLoadCount: number;
42
43
  progressFormat(percentage: any): string;
@@ -82,6 +83,7 @@ export default class ViewerWrapper extends Vue {
82
83
  /** 仅项目 Viewer 按配置显示项目效果工具栏,普通模型 Viewer 保持纯模型工具栏。 */
83
84
  get showEditToolbar(): boolean;
84
85
  get loading(): {
86
+ enabled?: boolean;
85
87
  visible?: boolean;
86
88
  background?: string;
87
89
  };
@@ -92,7 +94,6 @@ export default class ViewerWrapper extends Vue {
92
94
  * 监听实际容器尺寸后同步 WebGL 画布,避免工具栏显隐后只在顶部局部区域渲染。
93
95
  */
94
96
  observeViewerResize(viewer: Viewer): void;
95
- checkLoadingStatus(): void;
96
97
  mounted(): void;
97
98
  beforeDestroy(): void;
98
99
  }
@@ -64,6 +64,7 @@ export declare class MeshComponent extends PropertyLivingComponent {
64
64
  borderPointCount: number;
65
65
  private meshByteLength;
66
66
  private indexesLength;
67
+ private meshLoadVersion;
67
68
  meshType: number;
68
69
  protected _receiveShadows: boolean;
69
70
  /**
@@ -191,6 +192,8 @@ export declare class MeshComponent extends PropertyLivingComponent {
191
192
  * @param meshType 要创建的网格类型
192
193
  */
193
194
  createMeshFromCacheData(meshData: MeshData, meshType: MeshType): Promise<void>;
195
+ /** 离场后即使重新加入同一 Viewer,旧解压和排队任务也不能向新生命周期写入 Mesh。 */
196
+ private isMeshLoadCurrent;
194
197
  private InternalLoadCreateMesh;
195
198
  /**
196
199
  * 创建`Marker`;同时调用创建球体,并更新`position`、`diffuseColor`,得到后续计算或渲染直接使用的数据或资源。