gs-bim-air 3.0.3 → 3.0.5

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

@@ -34,30 +34,6 @@
 
 ## 特性
 
-### currentLoaded
-
-> **currentLoaded**: `number` = `-1`
-
-***
-
-### currentLoadingKey
-
-> **currentLoadingKey**: `List`\<`number`\>
-
-***
-
-### currentToLoadCount
-
-> **currentToLoadCount**: `number` = `-1`
-
-***
-
-### debugBoundingboxSeg
-
-> **debugBoundingboxSeg**: `Segment` = `null`
-
-***
-
 ### firstMeshLoaded
 
 > **firstMeshLoaded**: `Observable`\<[`Viewer`](../../../classes/Viewer.md)\>
@@ -66,32 +42,6 @@
 
 ***
 
-### hasChildLoaded
-
-> **hasChildLoaded**: `boolean` = `false`
-
-***
-
-### hlodLoadedList
-
-> **hlodLoadedList**: `List`\<`ModelObject`\>
-
-处理HLOD调度删除父节点或子节点的列表
-
-***
-
-### isDebug
-
-> **isDebug**: `boolean` = `false`
-
-***
-
-### level1List
-
-> **level1List**: `List`\<`ModelObject`\>
-
-***
-
 ### loadedRenderObjects
 
 > **loadedRenderObjects**: `Map`\<`string`, `ModelObject`\>
@@ -101,30 +51,6 @@
 
 ***
 
-### loadingLevel1Finish
-
-> **loadingLevel1Finish**: `boolean` = `false`
-
-***
-
-### loadingList
-
-> **loadingList**: `List`\<`ModelObject`\>
-
-***
-
-### maxComponentProcessintCount
-
-> **maxComponentProcessintCount**: `number` = `50`
-
-***
-
-### minGe
-
-> **minGe**: `number` = `16`
-
-***
-
 ### modelObjectsLoaded
 
 > **modelObjectsLoaded**: `Observable`\<`ModelObject`[]\>
@@ -139,18 +65,6 @@
 
 ***
 
-### requestingLimit
-
-> **requestingLimit**: `number` = `10`
-
-***
-
-### requestingList
-
-> **requestingList**: `List`\<`ModelObject`\>
-
-***
-
 ### screenError
 
 > **screenError**: `number` = `16`
@@ -197,24 +111,6 @@
 
 要加载的目标RO，且仅需要显示的RO.（不包含镜头外和镜头内其他层级的RO）
 
-***
-
-### tempLoadingList
-
-> **tempLoadingList**: `List`\<`ModelObject`\>
-
-***
-
-### toLoadList
-
-> **toLoadList**: `List`\<`ModelObject`\>
-
-***
-
-### updatingStateHashTable
-
-> **updatingStateHashTable**: `Map`\<`string`, `ModelObject`\>
-
 ## 访问器
 
 ### viewer

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

@@ -34,13 +34,15 @@
 
 > **gpuPicker**: [`GPUHLODPicker`](../../Rendering/classes/GPUHLODPicker.md)
 
+GPU HLOD 采样拾取器（用于高性能像素拾取）
+
 ***
 
 ### selectedObject
 
 > **selectedObject**: [`TreeNodeObject`](../../../classes/TreeNodeObject.md) = `null`
 
-选中的节点
+当前选中的 TreeNodeObject（最后一个被选中的节点）
 
 ***
 
@@ -48,13 +50,17 @@
 
 > **selectedObjectsMap**: `Map`\<`string`, [`TreeNodeObject`](../../../classes/TreeNodeObject.md)\>
 
+多选的节点映射，key 为 treeNode.id，value 为 TreeNodeObject
+说明：用于实现多选集合并与快速删除
+
 ***
 
 ### selectedPos
 
 > **selectedPos**: `Vector3`
 
-选中的坐标点
+选中的世界坐标点
+说明：由 pick 操作返回的世界位置（Float32Array/Vector3），用于放置标注或获取点击位置
 
 ## 访问器
 
@@ -72,7 +78,8 @@
 
 > `get` **selectedObjects**(): [`TreeNodeObject`](../../../classes/TreeNodeObject.md)[]
 
-选中的节点组
+以数组形式返回当前选中的节点组（从 selectedObjectsMap 转换）
+说明：getter 会复制 Map 中的值为数组，避免外部直接修改内部 Map。
 
 #### 返回
 
@@ -98,12 +105,15 @@
 
 > **clearSelectionAndHighlight**(...`value`): `void`
 
-取消多个选择，若不传参则取消全部选择
+取消选择并清除高亮
 
 #### 参数
 
 • ...**value**: [`TreeNodeObject`](../../../classes/TreeNodeObject.md)[]
 
+可变参数，传入若干 TreeNodeObject 表示取消这些节点的选中；不传参则取消全部选择
+说明：会从 selectedObjectsMap 中删除对应节点并调用 styleManager.clearHighlight 同步样式。
+
 #### 返回
 
 `void`
@@ -130,12 +140,15 @@ Releases all held resources
 
 > **selectAndHighlight**(...`value`): `void`
 
-选择多个
+选择并高亮多个节点（追加选择）
 
 #### 参数
 
 • ...**value**: [`TreeNodeObject`](../../../classes/TreeNodeObject.md)[]
 
+要选中的 TreeNodeObject 列表
+说明：最后一个传入的节点会被视为当前选中对象（selectedObject），并将所有节点加入 selectedObjectsMap，同时调用 styleManager.highlight。
+
 #### 返回
 
 `void`
@@ -146,32 +159,48 @@ Releases all held resources
 
 > **selectByArea**(`startPixelPos`, `endPixelPos`): [`TreeNodeObject`](../../../classes/TreeNodeObject.md)[]
 
+框选区域内的构件（屏幕空间矩形选择）
+
 #### 参数
 
 • **startPixelPos**: `Float32Array`
 
+起始像素 [x,y]
+
 • **endPixelPos**: `Float32Array`
 
+结束像素 [x,y]
+
 #### 返回
 
 [`TreeNodeObject`](../../../classes/TreeNodeObject.md)[]
 
+选中的 TreeNodeObject 数组
+说明：遍历结构树中的节点，使用 worldPointToPixelPoint 将节点包围盒投影到屏幕，判断是否完全位于框内。
+
 ***
 
 ### selectByPoint()
 
 > **selectByPoint**(`pixelPos`, `isPickTreeNode`): `Promise`\<`object`\>
 
+根据屏幕像素点执行一次拾取（点选）并返回拾取信息
+
 #### 参数
 
 • **pixelPos**: `Vector3`
 
+屏幕像素坐标（Vector3，使用 x/y）
+
 • **isPickTreeNode**: `boolean` = `false`
 
 #### 返回
 
 `Promise`\<`object`\>
 
+Promise<{selectedGeoKey, worldPosition, treeNodeObject}|null>
+说明：优先使用 GPUHLODPicker 执行高性能拾取，若命中则设置 selectedObject 与 selectedPos 并返回详细信息。
+
 ##### selectedGeoKey
 
 > **selectedGeoKey**: `number` = `value.componentId`

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

@@ -34,19 +34,42 @@
 
 > **changeRoIds**: `any`[] = `[]`
 
+记录需要更新样式的 roId 列表（updateAllStyle 使用后会清空）
+
 ***
 
 ### geoKeyMeshsMap
 
 > **geoKeyMeshsMap**: `Map`\<`number`, `object`\>
 
+geoKey -> { modelObjectId -> subMesh[] } 的映射
+说明：用于快速从 treeNode 的 geometryKey 定位对应的 subMesh 列表
+
+***
+
+### highlightColor
+
+> **highlightColor**: `number`[]
+
+高亮颜色（默认）
+格式：[r,g,b,a]，r/g/b 范围 0-255，a 为透明度 0-1
+
+***
+
+### isolationColor
+
+> **isolationColor**: `number`[]
+
+隔离显示颜色（默认）
+
 ***
 
 ### roIdGeoKeyLlistListHashTable
 
 > **roIdGeoKeyLlistListHashTable**: `object` = `{}`
 
-roId、几何key对应的拆分列表
+存储每个渲染对象的几何拆分信息（用于 HLOD 或按样式拆分）
+结构：{ [roId]: { keyString: string, indexListList: List<List<number>> } }
 
 #### 索引签名
 
@@ -58,7 +81,8 @@ roId、几何key对应的拆分列表
 
 > **roIdGeoKeyStyleConfigHashTable**: `object` = `{}`
 
-roId、几何key对应的样式配置
+存储每个渲染对象（roId）下每个几何块（geoKey）对应的样式配置
+结构：{ [roId]: { [geoKey]: StyleConfig } }
 
 #### 索引签名
 
@@ -70,6 +94,8 @@ roId、几何key对应的样式配置
 
 > **shaders**: `object` = `{}`
 
+存放自定义 shader 配置（以 styleKey 为索引）
+
 ***
 
 ### treeNodeIdMapColor
@@ -418,14 +444,20 @@ Releases all held resources
 
 > **getTreeNodeMeshs**(`treeNodeObject`): `object`
 
+根据 TreeNode 的 geometryKey 返回对应的 subMesh 映射
+
 #### 参数
 
 • **treeNodeObject**: [`TreeNodeObject`](../../../classes/TreeNodeObject.md)
 
+TreeNodeObject，需包含 geometryKey
+
 #### 返回
 
 `object`
 
+若存在则返回 { [modelObjectId]: SubMesh[] } 映射，否则返回 null
+
 ***
 
 ### highlight()