gs-bim-air 3.0.3 → 3.0.5

package/.git

@@ -0,0 +1 @@
+gitdir: ../../.git/modules/packages/bimAir

package/README.md

@@ -1,6 +1,25 @@
 ## BIMAir 更新日志
 
-### 3.0.2
+### 3.0.5
+
+> 更新 public/js 里的内核文件，安装此版本需替换 js 文件夹
+
+- fix: 添加节点拖拽取消的处理函数
+- fix: 修复当前显存数据大于限制值时的 HLOD 加载逻辑
+- fix: 优化同颜色修改构件的 material 数量
+
+### 3.0.4
+
+> 更新 public/js 里的内核文件，安装此版本需替换 js 文件夹
+
+- fix: 修复一个加载项目会导致低精度的 mesh 无法删除的问
+- fix: 修复结构树节点编辑按钮样式，修复 panel 放大缩小事件阻拦、
+- fix: 恢复专业爆炸功能
+- fix: 修改线程占用数量
+- fix: 修复结构树网络请求返回数据有冲突，结构树数据无法正常解析，导致部分节点无法控制模型显示隐藏的问题
+- fix: 调整 viewerOptions 的应用顺序，viewer 创建成功后再应用配置
+
+### 3.0.3
 
 > 更新 public/js 里的内核文件，安装此版本需替换 js 文件夹
 

package/docs/classes/CameraMouse.md

@@ -361,7 +361,7 @@ false = 滚轮往后放大，往前缩小
 
 ### useGPUPick
 
-> **useGPUPick**: `boolean` = `false`
+> **useGPUPick**: `boolean` = `true`
 
 是否使用GPUPick
 

package/docs/classes/EarthCameraMouse3D.md

@@ -364,7 +364,7 @@ false = 滚轮往后放大，往前缩小
 
 ### useGPUPick
 
-> **useGPUPick**: `boolean` = `false`
+> **useGPUPick**: `boolean` = `true`
 
 是否使用GPUPick
 

package/docs/classes/Process.md

@@ -146,7 +146,7 @@
 
 ### maxMemorySize\_GB
 
-> `static` **maxMemorySize\_GB**: `number` = `4`
+> `static` **maxMemorySize\_GB**: `number` = `8`
 
 #### 继承自
 
@@ -880,6 +880,8 @@
 
 > `static` **checkOutOfMemory**(): `void`
 
+校验当前显存数据是否大于4G.
+
 #### 返回
 
 `void`

package/docs/classes/ThirdPersonOperator.md

@@ -388,7 +388,7 @@ false = 滚轮往后放大，往前缩小
 
 ### useGPUPick
 
-> **useGPUPick**: `boolean` = `false`
+> **useGPUPick**: `boolean` = `true`
 
 是否使用GPUPick
 

package/docs/classes/TreeNodeObject.md

@@ -492,7 +492,7 @@
 
 ### addWithRequestApi()
 
-> **addWithRequestApi**(`name`, `isUpdateTree`): `Promise`\<[`TreeNodeObject`](TreeNodeObject.md)\>
+> **addWithRequestApi**(`name`, `isUpdateTree`): `Promise`\<`object`\>
 
 添加子节点并请求API
 
@@ -504,7 +504,15 @@
 
 #### 返回
 
-`Promise`\<[`TreeNodeObject`](TreeNodeObject.md)\>
+`Promise`\<`object`\>
+
+##### res
+
+> **res**: `any`
+
+##### treeNodeObject
+
+> **treeNodeObject**: [`TreeNodeObject`](TreeNodeObject.md)
 
 ***
 
@@ -656,7 +664,7 @@
 
 ### moveToWithRequestApi()
 
-> **moveToWithRequestApi**(`treeNode`, `moveIndex`): `Promise`\<`void`\>
+> **moveToWithRequestApi**(`treeNode`, `moveIndex`): `Promise`\<`AxiosResponse`\<`any`, `any`\>\>
 
 移动节点到指定索引并请求API
 
@@ -668,7 +676,7 @@
 
 #### 返回
 
-`Promise`\<`void`\>
+`Promise`\<`AxiosResponse`\<`any`, `any`\>\>
 
 ***
 

package/docs/classes/Viewer.md

@@ -216,7 +216,7 @@ LUT文件可在PhotoShop等图像编辑软件生成，
 
 ### isDeleteLoaded
 
-> **isDeleteLoaded**: `boolean` = `true`
+> **isDeleteLoaded**: `boolean` = `false`
 
 是否删除镜头已加载的RO
 
@@ -1532,26 +1532,6 @@ Viewer的配置
 
 ***
 
-### addPoint()
-
-> **addPoint**(`points`, `point`): `number`[]
-
-#### 参数
-
-• **points**: `number`[]
-
-• **point**: `number`[]
-
-#### 返回
-
-`number`[]
-
-#### 继承自
-
-`LonganViewer.addPoint`
-
-***
-
 ### appendMatrix()
 
 > **appendMatrix**(`originSegment`, `m`): `any`
@@ -1990,6 +1970,30 @@ Viewer的配置
 
 ***
 
+### drawBoundingbox\_Vector3()
+
+> **drawBoundingbox\_Vector3**(`bb`, `coff`): `Vector3`[][]
+
+绘制包围盒
+
+#### 参数
+
+• **bb**: `number`[]
+
+包围盒
+
+• **coff**: `number` = `1`
+
+#### 返回
+
+`Vector3`[][]
+
+#### 继承自
+
+`LonganViewer.drawBoundingbox_Vector3`
+
+***
+
 ### editEarthModelPosition()
 
 > **editEarthModelPosition**(`model`, `localOrigin`, `lonLatHeight`, `rotateDegree`): `void`

package/docs/namespaces/Animation/classes/MeadowEffect.md

@@ -88,9 +88,21 @@
 
 ### options
 
-> **options**: `any`
+> **options**: `object`
 
-#### 继承自
+#### imageIndex
+
+> **imageIndex**: `number`
+
+草地贴图序号选择
+
+#### points
+
+> **points**: `number`[]
+
+草地路径点
+
+#### 覆写了
 
 `Effect.options`
 

package/docs/namespaces/Managers/classes/EffectManager.md

@@ -34,12 +34,20 @@
 
 > **currentEffect**: `Effect`
 
+当前正在操作或最后创建/加载的效果实例
+说明：用于快速访问当前选中的效果（用于 UI 操作或编辑）。
+类型：Effect | undefined
+
 ***
 
 ### effects
 
 > **effects**: `Effect`[] = `[]`
 
+已加载的效果实例列表
+说明：存放当前 manager 管理的所有 Effect 实例（不一定全部处于激活状态）。
+类型：Effect[]
+
 ## 访问器
 
 ### viewer
@@ -60,28 +68,34 @@
 
 > **addEffect**(`effect`): `Promise`\<`void`\>
 
-添加效果
+将新效果保存到后端并添加到本地管理列表
 
 #### 参数
 
 • **effect**: `Effect`
 
+要添加的 Effect 实例（未必有 id）
+
 #### 返回
 
 `Promise`\<`void`\>
 
+Promise<void>，保存成功后会将后端返回的 id 赋值到 effect.id，并推入 this.effects
+
 ***
 
 ### deleteEffect()
 
 > **deleteEffect**(`effect`): `void`
 
-删除效果
+删除指定效果（便捷方法，等同于 deleteEffectById(effect.id)）
 
 #### 参数
 
 • **effect**: `Effect`
 
+要删除的 Effect 实例
+
 #### 返回
 
 `void`
@@ -92,27 +106,32 @@
 
 > **deleteEffectById**(`id`, `isRequest`): `Promise`\<`void`\>
 
-通过Id删除效果
+根据 id 删除效果（可选择是否请求后端同步删除）
 
 #### 参数
 
 • **id**: `string`
 
+要删除的效果 id
+
 • **isRequest**: `boolean` = `true`
 
-是否删除服务器的数据
+是否同时请求后端删除（默认 true）
 
 #### 返回
 
 `Promise`\<`void`\>
 
+Promise<any>，当后端返回成功时会在本地调用 dispose 并从列表中移除对应效果
+
 ***
 
 ### dispose()
 
 > **dispose**(): `void`
 
-销毁全部效果
+销毁管理器并释放所有效果资源
+说明：会调用父类 dispose，并对已加载的每个 Effect 调用 dispose()
 
 #### 返回
 
@@ -128,23 +147,27 @@
 
 > **editEffect**(`effect`): `Promise`\<[`VideoEffectOption`](../../Animation/interfaces/VideoEffectOption.md) \| [`SpotLightEffectOption`](../../Animation/interfaces/SpotLightEffectOption.md) \| [`WallEffectOption`](../../Animation/interfaces/WallEffectOption.md) \| [`EmissiveEffectOption`](../../Animation/interfaces/EmissiveEffectOption.md) \| [`FanScanEffectOption`](../../Animation/interfaces/FanScanEffectOption.md) \| [`FireEffectOption`](../../Animation/interfaces/FireEffectOption.md) \| [`FlashingEffectOption`](../../Animation/interfaces/FlashingEffectOption.md) \| [`HeatMap2DEffectOption`](../../Animation/interfaces/HeatMap2DEffectOption.md) \| [`MeadowEffectOption`](../../Animation/interfaces/MeadowEffectOption.md) \| [`AtmEffectOption`](../../Animation/interfaces/AtmEffectOption.md) \| [`SunEffectOption`](../../Animation/interfaces/SunEffectOption.md) \| [`SmokeEffectOption`](../../Animation/interfaces/SmokeEffectOption.md) \| [`SprayWaterEffectOption`](../../Animation/interfaces/SprayWaterEffectOption.md) \| [`UvEffectOption`](../../Animation/interfaces/UvEffectOption.md) \| [`WallScanEffectOption`](../../Animation/interfaces/WallScanEffectOption.md) \| [`WaterEffectOption`](../../Animation/interfaces/WaterEffectOption.md) \| [`WeatherEffectOption`](../../Animation/interfaces/WeatherEffectOption.md) \| [`HemisphereScanEffectOption`](../../Animation/interfaces/HemisphereScanEffectOption.md) \| [`RainEffectOption`](../../Animation/interfaces/RainEffectOption.md) \| [`FogEffectOption`](../../Animation/interfaces/FogEffectOption.md) \| [`SnowEffectOption`](../../Animation/interfaces/SnowEffectOption.md)\>
 
-编辑效果
+编辑已有效果并同步到后端
 
 #### 参数
 
 • **effect**: `Effect`
 
+需要更新的 Effect 实例（必须包含 id）
+
 #### 返回
 
 `Promise`\<[`VideoEffectOption`](../../Animation/interfaces/VideoEffectOption.md) \| [`SpotLightEffectOption`](../../Animation/interfaces/SpotLightEffectOption.md) \| [`WallEffectOption`](../../Animation/interfaces/WallEffectOption.md) \| [`EmissiveEffectOption`](../../Animation/interfaces/EmissiveEffectOption.md) \| [`FanScanEffectOption`](../../Animation/interfaces/FanScanEffectOption.md) \| [`FireEffectOption`](../../Animation/interfaces/FireEffectOption.md) \| [`FlashingEffectOption`](../../Animation/interfaces/FlashingEffectOption.md) \| [`HeatMap2DEffectOption`](../../Animation/interfaces/HeatMap2DEffectOption.md) \| [`MeadowEffectOption`](../../Animation/interfaces/MeadowEffectOption.md) \| [`AtmEffectOption`](../../Animation/interfaces/AtmEffectOption.md) \| [`SunEffectOption`](../../Animation/interfaces/SunEffectOption.md) \| [`SmokeEffectOption`](../../Animation/interfaces/SmokeEffectOption.md) \| [`SprayWaterEffectOption`](../../Animation/interfaces/SprayWaterEffectOption.md) \| [`UvEffectOption`](../../Animation/interfaces/UvEffectOption.md) \| [`WallScanEffectOption`](../../Animation/interfaces/WallScanEffectOption.md) \| [`WaterEffectOption`](../../Animation/interfaces/WaterEffectOption.md) \| [`WeatherEffectOption`](../../Animation/interfaces/WeatherEffectOption.md) \| [`HemisphereScanEffectOption`](../../Animation/interfaces/HemisphereScanEffectOption.md) \| [`RainEffectOption`](../../Animation/interfaces/RainEffectOption.md) \| [`FogEffectOption`](../../Animation/interfaces/FogEffectOption.md) \| [`SnowEffectOption`](../../Animation/interfaces/SnowEffectOption.md)\>
 
+Promise<any>，后端更新请求的返回值
+
 ***
 
 ### findEffectsByType()
 
 > **findEffectsByType**\<`T`\>(`type`): `T`[]
 
-通过类型获取效果数组
+根据效果类型筛选本地已加载的效果
 
 #### 类型参数
 
@@ -154,69 +177,82 @@
 
 • **type**: `string`
 
-效果类型
+效果类型字符串（如 'video','fire' 等）
 
 #### 返回
 
 `T`[]
 
+指定类型的 Effect 实例数组
+
 ***
 
 ### getEffectById()
 
 > **getEffectById**(`id`): `Effect`
 
-通过Id获取效果
+根据效果 id 在本地缓存中查找 Effect 实例
 
 #### 参数
 
 • **id**: `any`
 
+效果 id
+
 #### 返回
 
 `Effect`
 
+找到的 Effect 实例，未找到返回 null
+
 ***
 
 ### getEffectByName()
 
 > **getEffectByName**(`name`): `Effect`
 
-通过名字获取效果
+根据效果名称在本地缓存中查找 Effect 实例
 
 #### 参数
 
 • **name**: `any`
 
+效果名称
+
 #### 返回
 
 `Effect`
 
+找到的 Effect 实例，未找到返回 null
+
 ***
 
 ### getEffects()
 
 > **getEffects**(`projectId`): `Promise`\<`void`\>
 
-根据项目Id获取效果
+从后端获取指定项目的效果配置并加载
 
 #### 参数
 
 • **projectId**: `string`
 
-项目Id
+项目 ID（由后端识别）
 
 #### 返回
 
 `Promise`\<`void`\>
 
+Promise<void>，在加载完成后更新内部的 `effects` 列表
+说明：该方法会调用 projectService.getEffects，然后批量 loadEffects 并将结果保存到 `this.effects`。
+
 ***
 
 ### loadEffect()
 
 > **loadEffect**\<`T`\>(`effectOption`): `Promise`\<`T`\>
 
-加载单个效果
+根据配置创建并初始化单个效果实例
 
 #### 类型参数
 
@@ -226,26 +262,32 @@
 
 • **effectOption**: [`EffectOption`](../../Animation/type-aliases/EffectOption.md)
 
-效果配置
+效果配置对象，包含 type 和对应参数
 
 #### 返回
 
 `Promise`\<`T`\>
 
+Promise<T>，resolve 为创建并初始化后的 Effect 实例
+说明：创建后会调用 effect.fromJson(effectOption) 并执行 effect.create()，
+若效果默认 active 则会自动 show，否则 hide。
+
 ***
 
 ### loadEffects()
 
 > **loadEffects**(`effectOptions`): `Promise`\<`Effect`[]\>
 
-加载多个效果
+批量加载效果配置
 
 #### 参数
 
 • **effectOptions**: [`EffectOption`](../../Animation/type-aliases/EffectOption.md)[]
 
-效果配置数组
+效果配置数组，每项为 EffectOption
 
 #### 返回
 
 `Promise`\<`Effect`[]\>
+
+Promise，resolve 为所有效果创建完毕后的 Effect 实例数组

package/docs/namespaces/Managers/classes/ProjectManager.md

@@ -34,7 +34,8 @@
 
 > **currentProjectCenter**: `any` = `null`
 
-总的项目基点.
+当前项目的全局基点（Project center）。
+说明：在多模型组合时用于定位/平移模型以对齐项目基点，类型为 Vector3 或 null。
 
 ***
 
@@ -74,18 +75,26 @@
 
 > **projectLoaded**: `List`\<() => `void`\>
 
+项目加载完成的回调列表
+说明：外部可向该列表注册回调函数，项目完全加载并准备就绪后会调用 executeProjectLoaded()
+
 ***
 
 ### projected
 
 > **projected**: `List`\<(`renderObject`) => `void`\>
 
+投影相关回调列表
+说明：用于在模型加载或其它事件后执行对 renderObject 的投影处理回调
+
 ***
 
 ### sceneTree
 
 > **sceneTree**: `RenderObject` = `null`
 
+存储场景树的根 RenderObject（通常由 persistenceManager.open 返回）
+
 ## 访问器
 
 ### process
@@ -158,78 +167,119 @@
 
 > **loadMaterials**(`paths`): `WorkPromise`\<`Material`[]\>
 
+从系统资源加载材质定义（当前为占位实现）
+
 #### 参数
 
 • **paths**: `string`[]
 
+材质描述文件路径数组
+
 #### 返回
 
 `WorkPromise`\<`Material`[]\>
 
+WorkPromise<Material[]>
+
 ***
 
 ### loadModel()
 
 > **loadModel**(`modelId`, `isCache`, `isFromLocal`): `Promise`\<`ModelObject`\>
 
+加载单个模型（包含纹理、材质与 render.json）并返回解析后的 ModelObject
+
 #### 参数
 
 • **modelId**: `string`
 
+模型 id 或路径（若从本地加载，可能包含特殊前缀）
+
 • **isCache**: `boolean`
 
+是否启用缓存（从缓存/IndexedDB 拉取资源）
+
 • **isFromLocal**: `boolean`
 
+是否从本地资源加载（影响请求路径与缓存策略）
+
 #### 返回
 
 `Promise`\<`ModelObject`\>
 
+Promise<ModelObject> - 解析并构建好的渲染对象
+说明：函数会先请求模型相关的贴图与材质数据，之后请求 render.json 并通过 persistenceManager.open 恢复为 ModelObject。
+
 ***
 
 ### loadModels()
 
 > **loadModels**(`modelIds`, `isCache`, `isFromLocal`): `Promise`\<`ModelObject`[]\>
 
+批量加载多个模型
+
 #### 参数
 
 • **modelIds**: `string`[]
 
+模型 id 数组
+
 • **isCache**: `boolean`
 
+是否启用缓存
+
 • **isFromLocal**: `boolean`
 
+是否从本地加载
+
 #### 返回
 
 `Promise`\<`ModelObject`[]\>
 
+Promise<ModelObject[]> - 所有模型加载完成后的 ModelObject 数组
+说明：内部会序列化调用 loadModel，并在全部完成后调用 resetLightModelsPosition 与 executeProjectLoaded。
+
 ***
 
 ### loadShaders()
 
 > **loadShaders**(`paths`): `WorkPromise`\<`Shader`[]\>
 
+从系统资源加载 shader 定义并注册到 assetManager.shaders
+
 #### 参数
 
 • **paths**: `string`[]
 
+shader 描述文件路径数组
+
 #### 返回
 
 `WorkPromise`\<`Shader`[]\>
 
+WorkPromise<Shader[]> 包含加载并解析后的 Shader 实例
+
 ***
 
 ### loadTextures()
 
 > **loadTextures**(`paths`): `WorkPromise`\<`WebGLTexture`\>
 
+加载若干纹理资源并将其转换为内部 Texture2d 对象
+
 #### 参数
 
 • **paths**: `string`[]
 
+纹理资源路径数组
+
 #### 返回
 
 `WorkPromise`\<`WebGLTexture`\>
 
+WorkPromise<Texture2d>，resolve 后包含所有已创建的纹理
+说明：该方法通过 WorkManager 请求图片数据并转换为 InternalImage，再由 AssetManager 转换为 Texture 并注册。
+
 ***
 
 ### resetLightModelsPosition()