dxfview 0.0.4 → 0.0.5-beta

package/dist/types/core/viewers/DxfViewer.d.ts

@@ -1,7 +1,7 @@
 /**
- * @fileoverview DxfViewer 类 - DXF/DWG 文件的 3D 查看器核心组件
+ * @fileoverview DxfViewer 类- DXF/DWG 文件的3D 查看器核心组件
  *
- * 这个文件实现了 DxfViewer 类，该类继承自 BaseViewer，专门用于渲染和交互 DXF/DWG 格式的工程图纸。
+ * 这个文件实现了DxfViewer 类，该类继承自BaseViewer，专门用于渲染和交互 DXF/DWG 格式的工程图纸。
  * 主要功能包括：
  * - 3D 场景渲染和相机控制
  * - 图层管理和可见性控制
@@ -26,6 +26,8 @@ import { FontManager } from "../../core/font";
 import { EventInfo } from "../../core/input/InputManager";
 import { MarkupManager, MarkupType } from "../../core/markup";
 import { Model2d, ModelData2d } from "../../core/model";
+import { // 几何体合并工具
+Batch } from "../../core/utils";
 import { BaseViewer, ViewerName } from "../../core/viewers/BaseViewer";
 import { MeasurementData, MeasurementType } from "../../plugins/measure";
 import type { MeasurementPlugin } from "../../plugins/measure";
@@ -37,7 +39,7 @@ import type { MeasurementPlugin } from "../../plugins/measure";
  * DxfViewer 不维护模型和标记数据之间的关系，业务逻辑应该知道
  * 一组标记数据属于哪个模型。
  *
- * 这个类型继承自 DrawableData，扩展了基础的可绘制数据结构，
+ * 这个类型继承自DrawableData，扩展了基础的可绘制数据结构，
  * 用于支持 DXF 查看器的标记功能，如注释、测量等。
  */
 export declare type MarkupData = DrawableData;
@@ -45,24 +47,32 @@ export declare type MarkupData = DrawableData;
  * @interface EntityData
  * @description 实体数据接口
  *
- * 这个接口定义了 DXF 实体的数据结构，包含实体所属的模型和图层信息。
+ * 这个接口定义了DXF 实体的数据结构，包含实体所属的模型和图层信息。
  * 用于在查看器中唯一标识和定位一个实体对象。
  *
- * @property {string} modelId - 模型唯一标识符，用于区分不同的 DXF 文件
+ * @property {string} modelId - 模型唯一标识符，用于区分不同的DXF 文件
  * @property {string} layerName - 图层名称，表示实体所在的图层
+ * @property {Batch} batch - 可选，合并前的原始实体批次信息（包含顶点范围、索引范围、用户数据等）
+ * @property {THREE.Object3D} mergedObject - 可选，合并后的 THREE.Object3D 对象（Mesh/Line/Points）
+ * @property {number} faceIndex - 可选，点击的面索引（仅 Mesh 类型）
+ * @property {number} lineIndex - 可选，点击的线索引（仅 Line/LineSegments 类型）
  */
 export interface EntityData {
     modelId: string;
     layerName: string;
+    batch?: Batch;
+    mergedObject?: THREE.Object3D;
+    faceIndex?: number;
+    lineIndex?: number;
 }
 /**
  * @interface DxfLayers
  * @description DXF/DWG 图层组接口
  *
  * 这个接口定义了一个图纸的所有图层集合，包含图层名称到图层对象的映射。
- * 用于管理和组织 DXF 文件中的图层信息，支持图层的显示/隐藏、颜色设置等操作。
+ * 用于管理和组织DXF 文件中的图层信息，支持图层的显示/隐藏、颜色设置等操作。
  *
- * @property {string} modelId - 模型唯一标识符，对应具体的 DXF 文件
+ * @property {string} modelId - 模型唯一标识符，对应具体的DXF 文件
  * @property {Record<string, DxfLayer>} layers - 图层映射表，键为图层名称，值为图层对象
  */
 export interface DxfLayers {
@@ -73,7 +83,7 @@ export interface DxfLayers {
  * @interface PdfLayers
  * @description PDF 图层组接口
  *
- * 这个接口定义了一个 PDF 文件的所有图层集合，虽然主要用于 DXF 查看器，
+ * 这个接口定义了一个PDF 文件的所有图层集合，虽然主要用于 DXF 查看器，
  * 但也支持 PDF 文件的图层管理功能。
  *
  * @property {string} modelId - 模型唯一标识符
@@ -87,7 +97,7 @@ export interface PdfLayers {
  * @interface PdfLayer
  * @description PDF 图层接口
  *
- * 这个接口定义了单个 PDF 图层的属性和状态信息。
+ * 这个接口定义了单个PDF 图层的属性和状态信息。
  * 用于控制 PDF 图层的显示和交互行为。
  *
  * @property {string} name - 图层名称，用于标识和显示
@@ -105,13 +115,13 @@ export interface PdfLayer {
  * @interface PdfData
  * @description PDF 数据接口
  *
- * 这个接口定义了 PDF 文件的数据结构，虽然主要用于 DXF 查看器，
+ * 这个接口定义了PDF 文件的数据结构，虽然主要用于 DXF 查看器，
  * 但也支持 PDF 文件的渲染和交互功能。
  *
  * @property {THREE.Object3D} threejsObject - 整个 DXF/PDF 文件的根 Three.js 对象
  * @property {Record<string, PdfLayer>} layers - 图层映射表，包含所有图层信息
  * @property {Record<string, THREE.Object3D[]>} layersAndThreejsObjects 可选 - 按图层名称组织的 Three.js 对象数组
- * @property {number} loadedEntityCount - 已创建/加载的实体数量，主要用于日志记录，不是精确值
+ * @property {number} loadedEntityCount - 已创建加载的实体数量，主要用于日志记录，不是精确值
  */
 export interface PdfData {
     threejsObject: THREE.Object3D;
@@ -123,7 +133,7 @@ export interface PdfData {
  * Threejs 对象按以下树状视图组织：
  *
  * - modelLevelObject1              (THREE.Group, name = <modelId>)
- *     - layoutLevelObject1         (THREE.Group, name = <布局名称>, 用于控制布局可见性)
+ *     - layoutLevelObject1         (THREE.Group, name = <布局名称>, 用于控制布局可见性
  *         - entityLevelObject1     (THREE.Point/Line/Mesh/Group)
  *
  * - 图层 threejs 对象
@@ -133,67 +143,67 @@ export interface PdfData {
  */
 /**
  * @class DxfViewer
- * @description DXF/DWG 文件查看器类 - 专业的工程图纸 3D 查看器
+ * @description DXF/DWG 文件查看器类 - 专业的工程图纸3D 查看器
  *
- * "dwg"是"drawing"的缩写，是AutoCAD保存的文件格式。
- * "dxf"是数据交换格式，可以从dwg文件转换而来。
- * 我们无法直接读取dwg文件，需要先通过ODA转换为dxf格式。
+ * "dwg"明drawing"的缩写，是AutoCAD保存的文件格式、
+ * "dxf"是数据交换格式，可以从dwg文件转换而来、
+ * 我们无法直接读取dwg文件，需要先通过ODA转换为dxf格式、
  *
- * 支持的DXF版本：AutoCAD 2018。同时支持二进制和ASCII格式。
+ * 支持的DXF版本：AutoCAD 2018。同时支持二进制和ASCII格式、
  *
  * JSON编码：UTF-8编码，无BOM
  *
- * 坐标系统：右手坐标系，Y轴向上
+ * 坐标系统：右手坐标系，Y轴向个
  *
- * 关于单位：
- * - 距离单位遵循主DXF文件的单位
- * - 面积单位遵循主DXF文件的单位
- * - 角度单位为"度"，逆时针方向
- * - 时间单位为"秒"
+ * 关于单位，
+ * - 距离单位遵循主DXF文件的单体
+ * - 面积单位遵循主DXF文件的单体
+ * - 角度单位个度，逆时针方合
+ * - 时间单位个移
  *
- * 颜色：使用rgb/rgba，值范围0-1
+ * 颜色：使用rgb/rgba，值范图-1
  *
- * 关于DxfViewer中的测量：
+ * 关于DxfViewer中的测量，
  * - 测量由DxfViewer生成
- * - 测量数据应该由用户存储，以便稍后恢复到DxfViewer中
+ * - 测量数据应该由用户存储，以便稍后恢复到DxfViewer个
  * - DxfViewer管理测量数据，可以创建、删除、隐藏等
  * - DxfViewer不维护测量与布局之间的关系
  *
- * 关于DxfViewer中的标记：
- * 标记与测量非常相似
+ * 关于DxfViewer中的标记，
+ * 标记与测量非常相传
  *
- * 关于DxfViewer中的热点：
+ * 关于DxfViewer中的热点，
  * - 热点由用户创建和存储
  * - 热点可以添加到DxfViewer中，也可以从中移除
  * - 调用者应该设置在当前DxfViewer会话中唯一的热点ID
- * - DxfViewer不会隐藏热点，用户可以自己操作
+ * - DxfViewer不会隐藏热点，用户可以自己操体
  * - DxfViewer不维护热点与布局之间的关系
  *
- * 关于布局：
+ * 关于布局，
  * - 每个布局都有自己的主视图
  * - 切换到另一个布局时，会清除所有测量、标记和热点
  * - 切换到另一个布局时，会停用任何正在进行的操作，如测量、标记等
  *
- * 关于叠加：
+ * 关于叠加，
  * - 只要浏览器有足够的内存、CPU/GPU等，就支持添加任意数量的模型
- * - 第一个模型称为"主模型"，其他的称为"叠加模型"
- * - 忽略叠加模型的图纸空间
- * - 如果叠加模型的单位与主模型不同，应该转换为主模型的单位
+ * - 第一个模型称个主模型，其他的称为"叠加模型"
+ * - 忽略叠加模型的图纸空闭
+ * - 如果叠加模型的单位与主模型不同，应该转换为主模型的单体
  * - 在getLayers()中会添加modelId作为前缀
  *
- * 关于比较：
- * - 只比较"模型"空间
+ * 关于比较，
+ * - 只比输模型"空间
  * - 比较具有相同句柄和类型的实体
  * - 比较实体的几何形状、位置、缩放等
  * - 忽略图层的可见性、冻结设置
  * - 忽略实体的属性，如线型、线宽、填充图案、字体、颜色等
- * - 忽略块引用的空间过滤器（xclip）
+ * - 忽略块引用的空间过滤器（xclip，
  * - 忽略与图层相关的操作，如将实体移动到另一个图层、更改图层颜色等
- * - 默认情况下，"添加"的实体以绿色渲染，"删除"的实体以红色渲染，"修改"的实体由两部分组成，一个"删除"和一个"添加"
+ * - 默认情况下，"添加"的实体以绿色渲染，删除"的实体以红色渲染，修改"的实体由两部分组成，一个删除"和一个添加"
  *
- * 关于撤销/重做：
+ * 关于撤销/重做，
  * - 支持测量和标记操作的撤销/重做。例如：创建/删除/移动标记
- * - 设置/移除一批测量或标记将被视为一个操作
+ * - 设置/移除一批测量或标记将被视为一个操体
  * - 切换到另一个布局会清除所有撤销/重做历史记录
  *
  * 关于对象捕捉（OSnap）：
@@ -229,17 +239,20 @@ export declare class DxfViewer extends BaseViewer {
     private readonly CAMERA_Z_POSITION;
     private readonly CAMERA_MIN_ZOOM;
     private timer;
-    /** @protected CSS2D渲染器 - 用于在场景中渲染HTML标签 */
+    /** @protected CSS2D渲染器- 用于在场景中渲染HTML标签 */
     protected css2dRenderer?: CSS2DRenderer;
-    /** @protected 字体管理器 - 处理文本渲染 */
+    /** @protected 字体管理器- 处理文本渲染 */
     protected fontManager?: FontManager;
     /** @protected 是否启用选择功能 */
     protected enableSelection?: boolean;
-    /** @protected 当前选中的对象 */
+    /** @protected 当前选中的对象*/
     protected selectedObject?: THREE.Object3D | Drawable;
+    private selectedEntityData?;
+    private selectedEntityHighlightObject?;
+    private boxSelectHelper?;
     /**
      * 已加载的模型列表
-     * 记录的"键"是modelId或src
+     * 记录的错是modelId或src
      * @internal
      */
     loadedModels: Model2d[];
@@ -248,19 +261,19 @@ export declare class DxfViewer extends BaseViewer {
      * @internal
      */
     masterModelId: string;
-    /** @private DXF布局栏组件 */
+    /** @private DXF布局栏组件*/
     private dxfLayoutBar?;
-    /** @private Three.js加载管理器 */
+    /** @private Three.js加载管理器*/
     private loadingManager?;
-    /** @private 射线投射器 - 用于对象拾取和交互 */
+    /** @private 射线投射器 - 用于对象拾取和交互*/
     private raycaster?;
-    /** @private 相机更新定时器 */
+    /** @private 相机更新定时器*/
     private cameraUpdateInterval?;
-    /** @protected 是否选中状态 - TODO: 与selectedObject重复？ */
+    /** @protected 是否选中状态 - TODO: 与selectedObject重复，*/
     protected selected: boolean;
-    /** @private 标记管理器 - 管理活动布局的标记 */
+    /** @private 标记管理器 - 管理活动布局的标记*/
     private markupManager?;
-    /** @private 缩放至矩形区域辅助工具 */
+    /** @private 缩放至矩形区域辅助工具*/
     private zoomToRectHelper?;
     /**
      * @private 请求动画帧辅助工具 - 用于提升渲染性能
@@ -268,7 +281,7 @@ export declare class DxfViewer extends BaseViewer {
      * 通过将raf设置为undefined可以禁用此功能
      */
     private raf?;
-    /** @private 时钟对象 - 用于时间相关的计算 */
+    /** @private 时钟对象 - 用于时间相关的计算*/
     private clock;
     /** @protected 渲染启用状态 - 与RafHelper配合使用 */
     protected renderEnabled: boolean;
@@ -294,7 +307,7 @@ export declare class DxfViewer extends BaseViewer {
     private fpsUtils;
     /** @private 正在拖拽的标注可绘制对象 */
     private draggingAnnotationDrawable?;
-    /** @private 正在拖拽的顶点索引 */
+    /** @private 正在拖拽的顶点索引*/
     private draggingVertexIndex?;
     /**
      * DxfViewer构造函数
@@ -331,7 +344,7 @@ export declare class DxfViewer extends BaseViewer {
     protected init(): void;
     private initInputManager;
     /**
-     * 交互模式：
+     * 交互模式，
      * select 模式：左键点击选择，鼠标中键拖拽平移；鼠标样式为默认；
      * move 模式：左键拖拽平移（与中键一致），鼠标样式为 pan/grab
      */
@@ -344,12 +357,12 @@ export declare class DxfViewer extends BaseViewer {
      * - "move"模式：用于快速平移视图，左键拖拽即可平移
      *
      * 两种模式的鼠标行为：
-     * select模式：
+     * select模式，
      *   - 左键：选择对象
      *   - 中键：拖拽平移视图
      *   - 鼠标样式：默认样式
      *
-     * move模式：
+     * move模式，
      *   - 左键：拖拽平移视图（与中键行为一致）
      *   - 鼠标样式：抓取样式(pan/grab)
      *
@@ -367,12 +380,12 @@ export declare class DxfViewer extends BaseViewer {
     setInteractionMode(mode: "select" | "move"): void;
     /**
      * 初始化Three.js核心组件
-     * 包括场景、渲染器和相机
+     * 包括场景、渲染器和相术
      */
     private initThree;
     /**
      * 初始化DOM相关组件
-     * 包括加载指示器、CSS2D渲染器、进度条和布局栏
+     * 包括加载指示器、CSS2D渲染器、进度条和布局标
      */
     private initDom;
     /**
@@ -382,22 +395,22 @@ export declare class DxfViewer extends BaseViewer {
     private initScene;
     /**
      * 初始化WebGL渲染器
-     * 配置渲染参数并设置到DOM中
+     * 配置渲染参数并设置到DOM个
      */
     private initRenderer;
     /**
      * 初始化CSS2D渲染器
-     * 用于渲染HTML标签和标注
+     * 用于渲染HTML标签和标法
      */
     protected initCSS2DRenderer(): void;
     /**
-     * 初始化正交相机
+     * 初始化正交相术
      * 设置相机位置、缩放和投影矩阵
      */
     private initCamera;
     /**
      * 初始化相机控制器
-     * 设置鼠标和触摸交互行为
+     * 设置鼠标和触摸交互行个
      * @internal
      */
     protected initControls(): void;
@@ -411,19 +424,19 @@ export declare class DxfViewer extends BaseViewer {
      */
     protected onControlsChange(viewer: DxfViewer): () => void;
     /**
-     * 初始化鼠标/指针事件
+     * 初始化鼠标指针事件
      * 处理各种交互事件如点击、拖拽、键盘快捷键等
      */
     private initEvents;
     protected initOthers(): void;
     private initLoadingProgressBar;
     /**
-     * 显示布局栏
+     * 显示布局标
      * @internal
      */
     showLayoutBar(): void;
     /**
-     * 隐藏布局栏
+     * 隐藏布局标
      * @internal
      */
     hideLayoutBar(): void;
@@ -432,19 +445,19 @@ export declare class DxfViewer extends BaseViewer {
      * 启用渲染以提升性能
      *
      * 为获得更好的性能，应该只在必要时进行渲染。通常在以下情况应该启用渲染：
-     * - 对象被添加到场景、从场景移除，或对象的position、scale、rotation、opacity、material等属性发生变化
+     * - 对象被添加到场景、从场景移除，或对象的position、scale、rotation、opacity、material等属性发生变区
      * - 对象被选择或取消选择
      * - 相机发生变化
      * - 渲染区域大小发生变化
      *
-     * 这个方法会设置一个超时，在指定的时间后自动禁用渲染，从而避免不必要的渲染开销。
+     * 这个方法会设置一个超时，在指定的时间后自动禁用渲染，从而避免不必要的渲染开销、
      *
      * @param time - 渲染启用持续时间（毫秒），默认为1000ms
      * @internal 内部方法，主要由框架内部调用
      *
      * @example
      * ```typescript
-     * // 手动启用渲染，持续2秒
+     * // 手动启用渲染，持绘移
      * viewer.enableRender(2000);
      *
      * // 使用默认时间启用渲染
@@ -455,8 +468,8 @@ export declare class DxfViewer extends BaseViewer {
     /**
      * 获取当前的FPS（每秒帧数）值
      *
-     * 返回当前查看器的实时渲染帧率，用于性能监控和调试。
-     * FPS值反映了渲染性能的高低，数值越高表示性能越好。
+     * 返回当前查看器的实时渲染帧率，用于性能监控和调试、
+     * FPS值反映了渲染性能的高低，数值越高表示性能越好、
      *
      * @returns 当前的FPS值
      * @internal 内部方法，主要用于性能监控
@@ -469,29 +482,29 @@ export declare class DxfViewer extends BaseViewer {
      */
     getFps(): number;
     /**
-     * 判断是否为3D查看器
+     * 判断是否个D查看器
      *
-     * DxfViewer是2D查看器，专门用于渲染DXF/DWG格式的工程图纸。
-     * 这个方法返回false，表示当前查看器不支持3D渲染。
+     * DxfViewer明D查看器，专门用于渲染DXF/DWG格式的工程图纸、
+     * 这个方法返回false，表示当前查看器不支指D渲染、
      *
-     * @returns 总是返回false，因为DxfViewer是2D查看器
-     * @internal 内部方法，用于框架内部的查看器类型判断
+     * @returns 总是返回false，因为DxfViewer明D查看器
+     * @internal 内部方法，用于框架内部的查看器类型判方
      */
     is3d(): boolean;
     /**
-     * 销毁 DxfViewer 实例
+     * 销每DxfViewer 实例
      *
-     * 彻底清理和释放 DxfViewer 占用的所有资源，包括：
+     * 彻底清理和释改DxfViewer 占用的所有资源，包括，
      * - 停止所有异步任务和动画循环
      * - 销毁UI组件（布局栏、标记管理器等）
-     * - 清理Three.js资源（渲染器、几何体、材质等）
+     * - 清理Three.js资源（渲染器、几何体、材质等，
      * - 移除事件监听器
      * - 释放内存和GPU资源
      *
      * 注意：销毁顺序很重要，例如测量功能依赖于渲染器，
-     * 必须在销毁渲染器之前先销毁测量功能。
+     * 必须在销毁渲染器之前先销毁测量功能、
      *
-     * 调用此方法后，DxfViewer实例将不可用，所有相关资源都会被释放。
+     * 调用此方法后，DxfViewer实例将不可用，所有相关资源都会被释放、
      *
      * @example
      * ```typescript
@@ -502,6 +515,7 @@ export declare class DxfViewer extends BaseViewer {
      * ```
      */
     destroy(): void;
+    clearLoadedModels(): void;
     /**
      * 用于指示有多少个DXF文件正在加载
      */
@@ -511,24 +525,24 @@ export declare class DxfViewer extends BaseViewer {
      *
      * 加载DXF/DWG格式的工程图纸文件，支持主模型和叠加模型的概念：
      *
-     * **主模型 vs 叠加模型：**
-     * - 第一个加载的文件将被视为"主模型"
-     * - 后续加载的文件称为"叠加模型"
+     * **主模型vs 叠加模型，*
+     * - 第一个加载的文件将被视为"主模型
+     * - 后续加载的文件称个叠加模型"
      *
-     * **加载内容差异：**
-     * - **主模型**：加载所有内容，包括模型空间和图纸空间
+     * **加载内容差异，*
+     * - **主模型*：加载所有内容，包括模型空间和图纸空闭
      * - **叠加模型**：仅加载模型空间，且只能叠加到主模型的模型空间上
      *
      * **功能特性：**
      * - 支持进度回调，实时显示加载进度
      * - 支持本地缓存以提升性能
      * - 支持模型合并优化
-     * - 支持编码设置（处理不同字符集的DXF文件）
-     * - 支持颜色覆盖（统一修改模型颜色）
+     * - 支持编码设置（处理不同字符集的DXF文件，
+     * - 支持颜色覆盖（统一修改模型颜色，
      * - 自动处理图纸空间的忽略逻辑
      *
      * @param modelCfg - 要加载的模型配置
-     * @param onProgress - 加载进度回调函数，可选
+     * @param onProgress - 加载进度回调函数，可通
      *
      * @returns Promise<void> - 当模型加载完成时resolve
      *
@@ -543,7 +557,7 @@ export declare class DxfViewer extends BaseViewer {
      *
      * const modelCfg = {
      *     modelId: "primary_model",
-     *     name: "主模型",
+     *     name: "主模型,
      *     src: "http://example.com/primary.dxf",
      *     merge: true,              // 启用模型合并优化
      *     encoding: "utf-8",        // 文件编码
@@ -557,11 +571,11 @@ export declare class DxfViewer extends BaseViewer {
      *         const progress = (event.loaded * 100) / event.total;
      *         console.log(`加载进度: ${progress.toFixed(1)}%`);
      *
-     *         // 可以在这里更新UI进度条
+     *         // 可以在这里更新UI进度材
      *         updateProgressBar(progress);
      *     });
      *
-     *     console.log("模型加载完成！");
+     *     console.log("模型加载完成，);
      *
      *     // 现在可以加载叠加模型
      *     const overlayCfg = {
@@ -583,11 +597,11 @@ export declare class DxfViewer extends BaseViewer {
      *
      * @example
      * ```typescript
-     * // 加载多个模型的示例
+     * // 加载多个模型的示供
      * const models = [
      *     { modelId: "floor1", name: "一层平面图", src: "floor1.dxf" },
-     *     { modelId: "floor2", name: "二层平面图", src: "floor2.dxf" },
-     *     { modelId: "structure", name: "结构图", src: "structure.dxf" },
+     *     { modelId: "floor2", name: "二层平面图, src: "floor2.dxf" },
+     *     { modelId: "structure", name: "结构图, src: "structure.dxf" },
      * ];
      *
      * for (const model of models) {
@@ -598,13 +612,14 @@ export declare class DxfViewer extends BaseViewer {
      * ```
      */
     loadModelAsync(modelCfg: DxfModelConfig, onProgress?: (event: ProgressEvent) => void): Promise<void>;
+    private disposeSceneObjectResources;
     /**
      * 卸载DXF模型
      *
-     * 从查看器中移除指定的DXF模型，清理相关资源。
-     * 这个方法目前还没有实现，是为未来版本预留的功能。
+     * 从查看器中移除指定的DXF模型，清理相关资源、
+     * 这个方法目前还没有实现，是为未来版本预留的功能、
      *
-     * @param modelId 可选 - 要卸载的模型ID。如果不提供，则可能卸载所有模型
+     * @param modelId 可通- 要卸载的模型ID。如果不提供，则可能卸载所有模型
      * @internal 内部方法，暂未实现
      * @throws {Error} 抛出"Not implemented yet!"错误，表示功能尚未实现
      *
@@ -619,7 +634,7 @@ export declare class DxfViewer extends BaseViewer {
      * 将模型数据添加到查看器
      *
      * 这个方法负责将加载的DXF模型正式集成到Three.js场景中，
-     * 设置必要的属性和状态，确保模型能够正确渲染和交互。
+     * 设置必要的属性和状态，确保模型能够正确渲染和交互、
      *
      * @param modelData - 2D模型数据，包含模型ID和DXF数据
      * @returns 返回创建的Model2d实例
@@ -647,10 +662,10 @@ export declare class DxfViewer extends BaseViewer {
     protected getLoadedDxfModelIds(): string[];
     /**
      * @description {en} Gets layout names of the master model.
-     * @description {zh} 获取主模型的布局名称。
+     * @description {zh} 获取主模型的布局名称、
      * @returns
      * - {en} Layout names of the master model.
-     * - {zh} 主模型的布局名称。
+     * - {zh} 主模型的布局名称、
      * @example
      * ```typescript
      * const layoutNames = dxfViewer.getLayoutNames();
@@ -659,17 +674,17 @@ export declare class DxfViewer extends BaseViewer {
      */
     getLayoutNames(): string[];
     /**
-     * 获取布局。
-     * 仅返回主模型的布局。
+     * 获取布局、
+     * 仅返回主模型的布局、
      */
     protected getLayouts(): ILayoutObject[];
     private handleOverlayDxf;
     /**
      * @description {en} Activates a layout.
-     * @description {zh} 激活布局。
+     * @description {zh} 激活布局、
      * @param layoutName
      * - {en} The name of the layout to be activated.
-     * - {zh} 要激活的布局名称。
+     * - {zh} 要激活的布局名称、
      * @example
      * ```typescript
      * viewer.activateLayout('Layout1');
@@ -679,10 +694,10 @@ export declare class DxfViewer extends BaseViewer {
     private cancelAllOperations;
     /**
      * @description {en} Gets active layout.
-     * @description {zh} 获取当前布局。
+     * @description {zh} 获取当前布局、
      * @returns
      * - {en} Active layout name or undefined.
-     * - {zh} 当前激活的布局名称或undefined。
+     * - {zh} 当前激活的布局名称或undefined、
      * @example
      * ``` typescript
      * const activeLayout = viewer.getActiveLayoutName();
@@ -692,10 +707,10 @@ export declare class DxfViewer extends BaseViewer {
     getActiveLayoutName(): string | undefined;
     /**
      * @description {en} Gets dxf layers.
-     * @description {zh} 获取dxf图层。
+     * @description {zh} 获取dxf图层、
      * @returns
      * - {en} Dxf layers.
-     * - {zh} dxf图层。
+     * - {zh} dxf图层、
      * @example
      * ``` typescript
      * const dxfLayers = viewer.getLayers();
@@ -708,26 +723,26 @@ export declare class DxfViewer extends BaseViewer {
      */
     getLayers(): (DxfLayers | PdfLayers)[];
     /**
-     * 设置模型（即dxf文件）的可见性。
-     * @throws 如果modelId不存在则抛出异常。
+     * 设置模型（即dxf文件）的可见性、
+     * @throws 如果modelId不存在则抛出异常、
      * @internal
      */
     setModelVisibility(modelId: string, visible: boolean): void;
     /**
      * @description {en} Sets layer's visibility.
-     * @description {zh} 设置图层的可见性。
+     * @description {zh} 设置图层的可见性、
      * @param layerName
      * - {en} Layer's name to show or hide.
-     * - {zh} 要显示或隐藏的图层名称。
+     * - {zh} 要显示或隐藏的图层名称、
      * @param visible
      * - {en} Layer's target visibility.
-     * - {zh} 图层的目标可见性。
+     * - {zh} 图层的目标可见性、
      * @param modelId
      * - {en} Useful when more than one model is loaded, if not specified, will use the master model.
-     * - {zh} 当加载了多个模型时有用，如果未指定，将使用主模型。
+     * - {zh} 当加载了多个模型时有用，如果未指定，将使用主模型、
      * @throws Error
      * - {en}: Throws exception if given modelId doesn't exist.
-     * - {zh} 如果给定的modelId不存在，则抛出异常。
+     * - {zh} 如果给定的modelId不存在，则抛出异常、
      * @example
      * ``` typescript
      * // Hides layer "0"
@@ -742,12 +757,12 @@ export declare class DxfViewer extends BaseViewer {
     setLayerOpacity(layerName: string, opacity: number, modelId?: string): void;
     /**
      * 设置图层的颜色
-     * @throws 如果图层不存在则抛出异常。
+     * @throws 如果图层不存在则抛出异常、
      * @internal
      */
     setLayerColor(layerName: string, color: number, modelId?: string): void;
     /**
-     * 重置图层的颜色。
+     * 重置图层的颜色、
      * @internal
      */
     resetLayerColor(layerName: string, modelId?: string): void;
@@ -755,12 +770,12 @@ export declare class DxfViewer extends BaseViewer {
      * @description {en} Sets font.
      * This needs to be called before loading a dxf, it won't affect any loaded text.
      * It accepts shx or typeface formats. For typeface, it only support passing in 1 font file in the array for now.
-     * @description {zh} 设置字体。
-     * 需要在加载dxf之前调用，不会影响已加载的文字。
-     * 支持shx或typeface格式。对于typeface，目前只支持传入1个字体文件。
+     * @description {zh} 设置字体、
+     * 需要在加载dxf之前调用，不会影响已加载的文字、
+     * 支持shx或typeface格式。对于typeface，目前只支持传入1个字体文件、
      * @param urls
      * - {en} font file urls.
-     * - {zh} 字体文件链接。
+     * - {zh} 字体文件链接、
      * @example
      * ```typescript
      * viewer.setFont(["https://example.com/xxx.shx"]);
@@ -769,9 +784,9 @@ export declare class DxfViewer extends BaseViewer {
     setFont(urls: string[]): Promise<void>;
     getFont(): FontManager | undefined;
     /**
-     * 设置加载管理器。
+     * 设置加载管理器、
      * @internal
-     * 需要在加载dxf之前调用，用于加载本地外部链接。
+     * 需要在加载dxf之前调用，用于加载本地外部链接、
      * @param manager
      */
     setLoadingManager(manager: THREE.LoadingManager): void;
@@ -796,8 +811,8 @@ export declare class DxfViewer extends BaseViewer {
     /**
      * @description {en} Gets current view extent.
      * This is useful for user to save this value as a viewpoint, and jump to this viewpoint next time.
-     * @description {zh} 获取当前视图范围。
-     * 用户可使用该接口获取当前视口范围，并在适当的场景下跳转到该视口范围。
+     * @description {zh} 获取当前视图范围、
+     * 用户可使用该接口获取当前视口范围，并在适当的场景下跳转到该视口范围、
      * @example
      * ``` typescript
      * const box = viewer.getCurrentViewExtent();
@@ -813,7 +828,7 @@ export declare class DxfViewer extends BaseViewer {
     get measurePlugin(): MeasurementPlugin | undefined;
     /**
      * @description {en} Activates one of "Distance", "Area" or "Angle" measurement
-     * @description {zh} 激活"距离", "面积" 或者 "角度"测量
+     * @description {zh} 激活距离", "面积" 或者"角度"测量
      * @param type
      * - "Distance", "Area" or "Angle"
      * @example
@@ -825,7 +840,7 @@ export declare class DxfViewer extends BaseViewer {
     activateMeasurement(type: MeasurementType): void;
     /**
      * @description {en} Deactivates measurement.
-     * @description {zh} 退出测量。
+     * @description {zh} 退出测量、
      * @example
      * ``` typescript
      * viewer.deactivateMeasurement();
@@ -835,7 +850,7 @@ export declare class DxfViewer extends BaseViewer {
     deactivateMeasurement(): void;
     /**
      * @description {en} Gets active measurement type.
-     * @description {zh} 获取当前激活的测量类型。
+     * @description {zh} 获取当前激活的测量类型、
      * @returns
      * - "Distance", "Area" or "Angle" or undefined
      * @example
@@ -848,10 +863,10 @@ export declare class DxfViewer extends BaseViewer {
     getActiveMeasurementType(): MeasurementType | undefined;
     /**
      * @description {en} Gets all measurements.
-     * @description {zh} 获取所有测量数据。
+     * @description {zh} 获取所有测量数据、
      * @returns
      * - {en} measurement data array.
-     * - {zh} 测量数据数组。
+     * - {zh} 测量数据数组、
      * @example
      * ``` typescript
      * const measurementData = viewer.getMeasurements();
@@ -862,16 +877,16 @@ export declare class DxfViewer extends BaseViewer {
     getMeasurements(): MeasurementData[];
     /**
      * @description {en} Cancels current measurement. This won't deactivate measurement, rather, you can start a new measurement.
-     * @description {zh} 取消当前的测量绘制。这并不会退出测量，用户可以开始一个新的测量。
+     * @description {zh} 取消当前的测量绘制。这并不会退出测量，用户可以开始一个新的测量、
      * @deprecated use MeasurePlugin instead
      */
     cancelMeasurement(): void;
     /**
      * @description {en} Sets measurement data.
-     * @description {zh} 设置测量数据。
+     * @description {zh} 设置测量数据、
      * @param measurementData
      * - {en} measurement data array.
-     * - {zh} 测量数据数组。
+     * - {zh} 测量数据数组、
      * @example
      * ``` typescript
      * const measurementData = [{
@@ -898,10 +913,10 @@ export declare class DxfViewer extends BaseViewer {
     unselectMeasurement(): void;
     /**
      * @description {en} Removes a measurement by id.
-     * @description {zh} 根据id删除测量数据。
+     * @description {zh} 根据id删除测量数据、
      * @param id
      * - {en} Measurement data id.
-     * - {zh} 测量数据id。
+     * - {zh} 测量数据id、
      * @example
      * ``` typescript
      * const id = "c6ea70a3-ddb0-4dd0-87c8-bd2491936428";
@@ -919,7 +934,7 @@ export declare class DxfViewer extends BaseViewer {
     setMeasurementVisibility(id: string, visible: boolean): boolean;
     /**
      * @description {en} Clears measurement results.
-     * @description {zh} 清除测量结果。
+     * @description {zh} 清除测量结果、
      * @example
      * ``` typescript
      * viewer.clearMeasurements();
@@ -934,10 +949,10 @@ export declare class DxfViewer extends BaseViewer {
     getMarkupManager(): MarkupManager | undefined;
     /**
      * @description {en} Activates markup feature.
-     * @description {zh} 激活标注功能。
+     * @description {zh} 激活标注功能、
      * @param type
      * - {en} markup type.
-     * - {zh} 标注类型。
+     * - {zh} 标注类型、
      * @example
      * ``` typescript
      * const markupType = MarkupType.Arrow;
@@ -948,7 +963,7 @@ export declare class DxfViewer extends BaseViewer {
     activateMarkup(type: MarkupType): void;
     /**
      * @description {en} Deactivates markup feature.
-     * @description {zh} 退出标注功能。
+     * @description {zh} 退出标注功能、
      * @example
      * ``` typescript
      * viewer.deactivateMarkup();
@@ -957,10 +972,10 @@ export declare class DxfViewer extends BaseViewer {
     deactivateMarkup(): void;
     /**
      * @description {en} Gets active markup type.
-     * @description {zh} 获取激活的标注类型。
+     * @description {zh} 获取激活的标注类型、
      * @returns
      * - {en} markup type.
-     * - {zh} 标注类型。
+     * - {zh} 标注类型、
      * @example
      * ``` typescript
      * const markupType = viewer.getActiveMarkupType();
@@ -1006,10 +1021,10 @@ export declare class DxfViewer extends BaseViewer {
     getMarkupFontSize(): number | undefined;
     /**
      * @description {en} Gets all markups.
-     * @description {zh} 获取所有标注数据。
+     * @description {zh} 获取所有标注数据、
      * @returns
      * - {en} markup data array.
-     * - {zh} 标注数据数组。
+     * - {zh} 标注数据数组、
      * @example
      * ``` typescript
      * const markupData = viewer.getMarkups();
@@ -1019,10 +1034,10 @@ export declare class DxfViewer extends BaseViewer {
     getMarkups(): MarkupData[];
     /**
      * @description {en} Adds markups to active layout.
-     * @description {zh} 添加标注到当前布局。
+     * @description {zh} 添加标注到当前布局、
      * @param markupDataArray
      * - {en} markup data array.
-     * - {zh} 标注数据数组。
+     * - {zh} 标注数据数组、
      * @example
      * ``` typescript
      * const markupData = [{
@@ -1045,13 +1060,13 @@ export declare class DxfViewer extends BaseViewer {
     setMarkupVisibility(id: string, visible: boolean): boolean;
     /**
      * @description {en} Updates a markup.
-     * @description {zh} 更新标注。
+     * @description {zh} 更新标注、
      * @param {MarkupData} markup
      * - {en} markup data.
-     * - {zh} 标注数据。
+     * - {zh} 标注数据、
      * @returns
      * - {en} Whether update successfully, true means success, false means failure.
-     * - {zh} 是否更新成功，true表示成功，false表示失败。
+     * - {zh} 是否更新成功，true表示成功，false表示失败、
      * @example
      * ``` typescript
      * const markupData = {
@@ -1067,13 +1082,13 @@ export declare class DxfViewer extends BaseViewer {
     updateMarkup(markup: MarkupData): boolean;
     /**
      * @description {en} Removes a markup by markup id.
-     * @description {zh} 根据标注id删除标注。
+     * @description {zh} 根据标注id删除标注、
      * @param {string} id
      * - {en} markup id.
-     * - {zh} 标注id。
+     * - {zh} 标注id、
      * @returns
      * - {en} Whether remove successfully, true means success, false means failure.
-     * - {zh} 是否删除成功，true表示成功，false表示失败。
+     * - {zh} 是否删除成功，true表示成功，false表示失败、
      * @example
      * ``` typescript
      * const markupId = "c6ea70a3-ddb0-4dd0-87c8-bd2491936428";
@@ -1083,7 +1098,7 @@ export declare class DxfViewer extends BaseViewer {
     removeMarkup(id: string): boolean;
     /**
      * @description {en} Clears markups.
-     * @description {zh} 清除所有标注。
+     * @description {zh} 清除所有标注、
      * @example
      * ``` typescript
      * viewer.clearMarkups();
@@ -1114,7 +1129,7 @@ export declare class DxfViewer extends BaseViewer {
     protected getHitResultByNdcCoordinate(coord: Vector2): Vector2 | undefined;
     /**
      * @description {en} Asks user to select a box area, and zooms to it.
-     * @description {zh} 询问用户选择一个框选区域，然后缩放到该区域。
+     * @description {zh} 询问用户选择一个框选区域，然后缩放到该区域、
      * @example
      * ``` typescript
      * viewer.zoomToRect();
@@ -1152,10 +1167,10 @@ export declare class DxfViewer extends BaseViewer {
      * @description {zh} 重置视图大小
      * @param {number} width
      * - {en} width of viewer
-     * - {zh} 视图宽度。
+     * - {zh} 视图宽度、
      * @param {number} height
      * - {en} height of viewer
-     * - {zh} 视图高度。
+     * - {zh} 视图高度、
      * @example
      * ```typescript
      * const width = 800;
@@ -1180,23 +1195,23 @@ export declare class DxfViewer extends BaseViewer {
     /**
      * 根据给定的鼠标位置获取相交对象
      *
-     * 使用射线投射技术检测鼠标位置与场景中的3D对象的相交情况。
-     * 这个方法是对象选择和交互的基础，用于确定用户点击了哪个对象。
+     * 使用射线投射技术检测鼠标位置与场景中的3D对象的相交情况、
+     * 这个方法是对象选择和交互的基础，用于确定用户点击了哪个对象、
      *
      * @param event - 鼠标事件信息，可选。如果不传入，则使用(0, 0)作为射线投射起点
-     * @returns 相交对象的数组，按距离排序（最近的在前）
+     * @returns 相交对象的数组，按距离排序（最近的在前，
      * @private 内部方法，仅供框架内部使用
      */
     private getIntersections;
     /**
-     * 重写：事件级缓存的射线相交
+     * 重写：事件级缓存的射线相事
      */
     intersectObjectsCached(event: EventInfo, objects: THREE.Object3D[], recursive: boolean, cacheKey: string): THREE.Intersection<THREE.Object3D<THREE.Event>>[];
     /**
      * 处理鼠标点击事件
      *
-     * 处理用户的鼠标点击交互，包括对象选择、取消选择等操作。
-     * 这个方法会检查各种状态（如测量模式、标注模式等）以避免冲突。
+     * 处理用户的鼠标点击交互，包括对象选择、取消选择等操作、
+     * 这个方法会检查各种状态（如测量模式、标注模式等）以避免冲突、
      *
      * @param event - 鼠标事件信息，包含点击位置、按钮状态等
      * @private 内部方法，由事件系统调用
@@ -1214,7 +1229,11 @@ export declare class DxfViewer extends BaseViewer {
      * 处理标注顶点拖拽结束
      */
     private handleAnnotationVertexDragEnd;
+    private findDrawableByEvent;
+    setSelectedOverlayDrawable(drawable?: Drawable | null): void;
+    private selectDrawable;
     private selectDrawableByEvent;
+    private isPreferredOverlayDrawable;
     /**
      * 检查对象是否为标注 drawable（鸭子类型检查）
      */
@@ -1225,7 +1244,7 @@ export declare class DxfViewer extends BaseViewer {
      */
     private selectSmallestDrawable;
     /**
-     * 判断 drawable 是否为封闭图形
+     * 判断 drawable 是否为封闭图录
      */
     private isClosedShape;
     /**
@@ -1245,15 +1264,141 @@ export declare class DxfViewer extends BaseViewer {
      */
     private calculateLineLength;
     /**
-     * 选择或取消选择一个对象。
-     * depthTest 默认关闭。当对象相互覆盖时，高亮效果会更加明显。
+     * 选择或取消选择一个对象、
+     * depthTest 默认关闭。当对象相互覆盖时，高亮效果会更加明显、
      */
-    protected selectObject(object?: THREE.Object3D, depthTest?: boolean): void;
+    protected selectObject(object?: THREE.Object3D, depthTest?: boolean, highlight?: boolean): void;
     /**
      * Clears the current selection
      * @internal
      */
     clearSelection(): void;
+    private clearEntityHighlight;
+    private highlightEntity;
+    private createEntityHighlightObject;
+    private extractBatchGeometry;
+    private getAttributeComponent;
+    private getNestedBatches;
+    private createAbsoluteBatch;
+    private resolveNestedMeshBatchByPointIndex;
+    private resolveNestedMeshBatch;
+    private resolveNestedLineBatchByIndex;
+    private resolveNestedLineBatch;
+    /**
+     * 通过屏幕坐标拾取合并前的单个实体信息
+     *
+     * 使用射线投射检测指定屏幕坐标处的实体，并通过 Batch 反查获取合并前的原始实体信息。
+     *
+     * @param screenX - 页面坐标 X（即 MouseEvent.clientX）
+     * @param screenY - 页面坐标 Y（即 MouseEvent.clientY）
+     * @returns 实体数据（包含 batch 信息），如果未命中则返回 undefined
+     */
+    getEntityAtPoint(screenX: number, screenY: number): EntityData | undefined;
+    /**
+     * 获取与单击选择高亮范围完全一致的闭合轮廓。
+     *
+     * - 命中 batch 时，提取与 `highlightEntity()` 相同的 batch 几何。
+     * - 未命中 batch 时，按 `selectObject()` 的整对象选择结果提取轮廓。
+     *
+     * 对于纯线条等非闭合对象，返回 `undefined`。
+     */
+    getSelectionRingsAtPoint(screenX: number, screenY: number): THREE.Vector3[][] | undefined;
+    /**
+     * 通过世界坐标拾取合并前的单个实体信息
+     *
+     * @param worldPoint - 世界坐标点
+     * @param radius - 搜索半径（世界坐标单位），默认使用当前 raycaster 阈值
+     * @returns 实体数据（包含 batch 信息），如果未命中则返回 undefined
+     */
+    getEntityAtWorldPoint(worldPoint: THREE.Vector3, radius?: number): EntityData | undefined;
+    /**
+     * 获取框选范围内的所有合并前实体信息
+     *
+     * 通过屏幕空间的矩形区域，提取该区域内所有合并前的原始实体（batch）信息。
+     *
+     * @param screenBox - 页面坐标的矩形区域 (Box2, 使用 MouseEvent.clientX/clientY 坐标系: min=左上, max=右下)
+     * @returns 框选范围内所有实体的数据数组
+     */
+    getEntitiesInScreenBox(screenBox: THREE.Box2): EntityData[];
+    /**
+     * 获取世界坐标 Box3 范围内的所有合并前实体信息
+     *
+     * @param worldBox - 世界坐标的包围盒
+     * @returns 范围内所有实体的数据数组
+     */
+    getEntitiesInWorldBox(worldBox: THREE.Box3): EntityData[];
+    /**
+     * 获取所有合并前的实体 batch 列表
+     *
+     * 遍历当前场景中所有可选择对象，收集所有 batch 信息。
+     *
+     * @returns 所有实体的数据数组
+     */
+    getAllEntities(): EntityData[];
+    /**
+     * 根据 batch 信息提取该实体的顶点数据（世界坐标）
+     *
+     * @param mergedObject - 合并后的 THREE.Object3D
+     * @param batch - 批次信息
+     * @returns 顶点坐标数组
+     */
+    getEntityVertices(mergedObject: THREE.Object3D, batch: Batch): THREE.Vector3[];
+    /**
+     * 根据 batch 信息计算该实体的包围盒
+     *
+     * @param mergedObject - 合并后的 THREE.Object3D
+     * @param batch - 批次信息
+     * @returns 包围盒
+     */
+    getEntityBoundingBox(mergedObject: THREE.Object3D, batch: Batch): THREE.Box3;
+    private getFirstVisibleIntersectionAtPoint;
+    private extractSelectionRingsFromEntity;
+    private shouldRejectCanvasSizedSelection;
+    private getCanvasSelectionFilterExtent;
+    private extractClosedPolygonsFromSelectionBatch;
+    private extractClosedPolygonsFromWholeSelectionObject;
+    private extractClosedPolygonsFromLineObject;
+    private resolveSelectionRings;
+    private buildSelectionLoopInfos;
+    private normalizeSelectionPolygon;
+    private isSelectionPolygonInside;
+    private findClosestFilledLoop;
+    private getDistanceToSelectionPolygonEdges;
+    private getDistanceToSelectionSegment;
+    /**
+     * 获取场景中可选择的对象列表
+     * 从已加载模型的当前布局中获取有几何体的叶子对象
+     */
+    private getSelectableSceneObjects;
+    /**
+     * 从 intersection 构建 EntityData
+     */
+    private buildEntityDataFromIntersection;
+    /**
+     * 从非合并对象构建 EntityData
+     */
+    private buildEntityDataFromObject;
+    /**
+     * 从 batch 信息构建 EntityData
+     */
+    private buildEntityDataFromBatch;
+    /**
+     * 递归查找对象所属的模型 ID（向上遍历到场景根节点的直接子对象）
+     */
+    private findModelIdByObject;
+    /**
+     * 计算 batch 的包围盒
+     */
+    private computeBatchBoundingBox;
+    /**
+     * 从 NDC 坐标的矩形构建视锥体
+     * 平面法线指向视锥体内部（THREE.Frustum 要求物体在所有平面的正半空间才算在视锥体内）
+     */
+    private buildFrustumFromNDCBox;
+    /**
+     * 收集视锥体内的所有实体
+     */
+    private collectEntitiesInFrustum;
     /**
      * 使相机飞向对象
      */
@@ -1267,7 +1412,7 @@ export declare class DxfViewer extends BaseViewer {
      */
     protected flyToSelectedObject(): void;
     /**
-     * 飞向随机对象（通过 alt + r）。
+     * 飞向随机对象（通过 alt + r）、
      * 当数据错误或程序有bug时很有用，
      * 这时我们在场景中看不到任何东西！
      */
@@ -1297,20 +1442,20 @@ export declare class DxfViewer extends BaseViewer {
     goToHomeView(): void;
     /**
      * @description {en} Zooms to specific bounding box.
-     * @description {zh} 缩放到指定的包围盒.
+     * @description {zh} 缩放到指定的包围监
      * @param bbox
      * - {en} 2d bounding box
-     * - {zh} 2d 包围盒。
+     * - {zh} 2d 包围盒、
      * @example
      * ``` typescript
      * const box = { min: { x: 0, y: 0 }, max: { x: 10000, y: 10000} };
      * viewer.zoomToBBox(box);
      * ```
      */
-    zoomToBBox(bbox: Box2): void;
+    zoomToBBox(bbox: Box2, animate?: boolean): void;
     /**
      * @description {en} Zooms to view extent.
-     * @description {zh} 缩放到视图范围.
+     * @description {zh} 缩放到视图范图
      * @example
      * ``` typescript
      * viewer.zoomToExtent();
@@ -1319,16 +1464,16 @@ export declare class DxfViewer extends BaseViewer {
     zoomToExtent(): void;
     /**
      * @description {en} Sets background color.
-     * @description {zh} 设置背景颜色。
+     * @description {zh} 设置背景颜色、
      * @param r
      * - {en} Red channel value between 0 and 1.
-     * - {zh} 红色通道值，介于 0 和 1 之间。
+     * - {zh} 红色通道值，介于 0 和1 之间、
      * @param g
      * - {en} Green channel value between 0 and 1.
-     * - {zh} 绿色通道值，介于 0 和 1 之间。
+     * - {zh} 绿色通道值，介于 0 和1 之间、
      * @param b
      * - {en} Blue channel value between 0 and 1.
-     * -{zh} 蓝色通道值，介于 0 和 1 之间。
+     * -{zh} 蓝色通道值，介于 0 和1 之间、
      * @example
      * ``` typescript
      * // {en} Sets background to gray
@@ -1342,7 +1487,7 @@ export declare class DxfViewer extends BaseViewer {
      */
     private getLayoutInfo;
     /**
-     * 创建一个比包围盒大得多的地面平面。
+     * 创建一个比包围盒大得多的地面平面、
      */
     private updateGroundPlane;
     /**