构造函数
支持简化的数组写法 [x, y]。
插入点坐标,支持 Point2D 或数组 [x, y]
文本字符串
文本高度
旋转角度
文本对齐方式
字体对象,默认为BIZ_UDGothic
颜色索引,默认为256
实体类型标识符(如"LINE"、"CIRCLE"等)
DWG对象ID(句柄)- 从DWG文件导入时的唯一标识符 这个值不应该在克隆时复制,新创建的实体应该为空字符串
实体索引ID - 从1开始递增的唯一索引 用于在WebCAD格式中标识实体
是否处于脏状态,供渲染器增量更新
Optionalblock获取颜色索引
颜色索引值(256表示"随图层"颜色)
设置颜色索引
颜色索引值(256表示"随图层"颜色)
获取图层ID
图层ID字符串
设置图层ID
图层ID字符串
获取线型比例
线型比例因子
设置线型比例
线型比例因子
获取线宽
线宽值(-1=ByLayer, -2=ByBlock, >=0为具体值,单位为0.01mm)
设置线宽
线宽值(-1=ByLayer, -2=ByBlock, >=0为具体值)
获取实体存活状态
是否存活(true表示有效,false表示已删除)
设置实体存活状态
是否存活
获取原始扩展数据(用于序列化) 格式: { "1001": "AppName", "1000": "JSON字符串" }
原始xdata对象或undefined
设置原始扩展数据(从数据库加载时使用)
原始xdata对象
获取扩展数据的应用程序名(AppName)
AppName字符串,或undefined
获取所属文档
通过实体所在的块来获取文档对象。在CAD系统中, 实体总是属于某个块,而块又属于某个文档。
文档对象,如果无法获取则返回undefined
获取图层名称
根据实体的layerId从文档的图层集合中查找对应的图层名称。 如果找不到对应的图层,则返回默认图层"0"。
图层名称,默认为"0"
设置图层名称
根据图层名称查找对应的图层ID并设置给实体。 如果找不到指定的图层,则使用默认图层ID("0")。
注意:优先使用实体所属文档的图层列表,如果实体尚未添加到文档, 则使用 Engine.currentDoc 的图层列表。
图层名称
获取线型
返回实体当前的线型设置。线型控制线条的显示样式 (如实线、虚线、点划线等)。
线型名称
设置线型
设置实体的线型,支持标准CAD线型、常见别名和自定义线型。 输入的线型名称会被转换为大写进行匹配。
支持的线型:
线型名称
获取文本样式名称
文本样式名称
设置文本样式名称
当设置样式名称时,会自动从文档的文本样式集合中获取对应的样式对象并设置。
新的文本样式名称
获取边框显示状态
是否显示边框
设置边框显示状态
边框在渲染时直接使用 getInnerCornerPoints() 获取范围渲染。
是否显示边框
获取文本高度
文本高度
设置文本高度
当文本高度改变时,重新计算边界框。
新的文本高度
获取旋转角度
旋转角度(弧度)
设置旋转角度
设置文本的旋转角度。
新的旋转角度(弧度)
获取文本对齐方式
文本对齐方式(Z枚举值)
设置文本对齐方式
当文本对齐方式改变时,重新计算边界框。
新的文本对齐方式(Z枚举值)
获取文本字符串
文本字符串内容
设置文本字符串
设置文本内容,自动解码Unicode字符串并应用文本替换规则。 当文本内容改变时,重新计算边界框。
新的文本字符串
获取文本内容(textString 的别名)
文本字符串内容
设置文本内容(textString 的别名)
新的文本字符串
清除扩展数据
检查是否有扩展数据
是否存在扩展数据
从默认属性对象复制属性
将指定的默认属性对象的所有相关属性复制到当前实体。 这通常用于创建新实体时应用默认设置。
默认属性对象,包含layer、colorIndex、lineType等属性
当前实例(支持链式调用)
设置为系统默认值
从全局CAD系统设置中获取当前的默认属性值并应用到实体。 这些默认值包括当前图层、当前颜色、当前线型等。
使用的全局变量:
从数据库默认属性对象设置属性
从数据库查询结果或序列化数据中恢复实体属性。 这个方法处理数据库中可能存在的空值和默认值情况。
数据库属性对象,包含layerId、colorIndex等属性
当前实例(支持链式调用)
将属性映射到数据库默认属性对象
将当前实体的属性映射到数据库存储格式的对象中。 用于保存实体数据到数据库或序列化。
目标数据库属性对象
映射后的属性对象
通知渲染系统此实体已被修改。
在桶渲染模式下,这将标记对应的桶为"脏",以便在下次 regenPartial 时重绘。
注意:此方法只标记,不触发重绘。调用方需要在适当的时候(如命令结束时)调用 regenPartial()。
设置旋转角度(方法形式) 提供与rotation setter相同的功能,用于API一致性
新的旋转角度(弧度)
通过关键字设置文本对齐方式
根据关键字字符串设置文本对齐方式。
对齐方式关键字
是否调整插入点位置,默认为true
设置文本对齐方式(带模式控制)
根据对齐方式设置文本,可选择是否自动调整插入点位置。
文本对齐方式(Z枚举值)
是否自动调整插入点位置,默认为true
获取内部角点坐标数组
获取内部文本框(不包含内边距)的四个角点坐标。 角点由 WASM 渲染阶段写回,格式为 [左下, 右下, 右上, 左上](世界坐标)
内部文本框的四个角点坐标数组
计算边界框
根据指定的坐标系计算文本的边界框。 使用 WASM 渲染时写回的角点数据。
坐标系类型(M.WCS、M.UCS、M.DCS)
边界框对象
获取文本对齐方式关键字
将数字形式的文本对齐方式转换为关键字字符串。 用于数据库存储和用户界面显示。
对齐方式关键字
通过关键字获取文本对齐方式数值
将关键字字符串转换为数字形式的文本对齐方式。 支持多种关键字格式,包括底部对齐的别名。
对齐方式关键字
对齐方式数值,无效关键字返回undefined
检查所有关键点是否在指定框内
判断文本的插入点是否在指定的边界框内。 这是一个简化的可见性检测方法。
边界框对象
如果插入点在框内返回true
镜像变换
对文本进行镜像变换,以指定的两点为镜像轴。 这是一个复杂的变换操作,需要根据文本的对齐方式和旋转角度 调整文本的位置和方向。
镜像轴起点
镜像轴终点
移动变换
将文本从一个位置移动到另一个位置。 移动插入点。
起始位置
目标位置
旋转变换
围绕指定点旋转文本。 旋转插入点和文本角度。
旋转中心点
旋转角度(弧度)
缩放变换
以指定点为中心对文本进行缩放。 缩放会影响插入点位置、文本高度和边界框。
缩放中心点
缩放因子
拉伸变形操作
根据拉伸框和移动向量对文本进行拉伸。 只有在拉伸框内的文本会被移动。
拉伸起始点
拉伸目标点
拉伸框对象
夹点编辑操作
处理文本的夹点编辑。目前只支持插入点的编辑。
新的夹点位置
夹点类型标识符
释放实体占用的外部资源 子类如持有 PIXI 对象或大尺寸缓冲,应覆盖此方法清理
文本实体类 表示CAD中的文本实体,继承自实体基类 包含文本内容、字体、对齐方式等属性,通过WASM进行矢量渲染
Example