实体类型标识符(如"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表示已删除)
设置实体存活状态
是否存活
DXF Group Code 60 entity visibility. true = visible (default), false = invisible.
获取原始扩展数据(用于序列化) 格式: { "1001": "AppName", "1000": "JSON字符串" }
原始xdata对象或undefined
设置原始扩展数据(从数据库加载时使用)
原始xdata对象
获取扩展数据的应用程序名(AppName)
AppName字符串,或undefined
获取所属文档
通过实体所在的块来获取文档对象。在CAD系统中, 实体总是属于某个块,而块又属于某个文档。
文档对象,如果无法获取则返回undefined
获取图层名称
根据实体的layerId从文档的图层集合中查找对应的图层名称。 如果找不到对应的图层,则返回默认图层"0"。
图层名称,默认为"0"
设置图层名称
根据图层名称查找对应的图层ID并设置给实体。 如果找不到指定的图层,则使用默认图层ID("0")。
注意:优先使用实体所属文档的图层列表,如果实体尚未添加到文档, 则使用 Engine.currentDoc 的图层列表。
图层名称
获取线型
返回实体当前的线型设置。线型控制线条的显示样式 (如实线、虚线、点划线等)。
线型名称
设置线型
设置实体的线型,支持标准CAD线型、常见别名和自定义线型。 输入的线型名称会被转换为大写进行匹配。
支持的线型:
线型名称
获取节点数量
节点数量
获取控制点数量
控制点数量
获取拟合点数量
拟合点数量
判断是否闭合
是否闭合
判断是否平面
是否平面(始终为true)
判断端点是否闭合
端点是否闭合
获取样条曲线长度 计算所有线段实体的总长度
曲线长度
获取样条曲线的轻量级几何体集合(用于几何计算和渲染)
与 subEnts 不同,此方法返回轻量级几何对象(GLine), 不包含实体属性(颜色、图层等),减少内存占用和计算开销。 支持缓存,通过 Engine.ENABLE_GEOMETRY_CACHE 控制。
轻量级几何体数组
检查是否自相交 检测样条曲线的线段是否存在自相交
是否自相交
检查区域是否闭合 判断样条曲线是否形成闭合区域
区域是否闭合
获取面积 样条曲线不支持面积计算
面积(样条曲线返回-1)
获取双倍面积 使用控制点计算多边形的双倍面积
双倍面积
检查是否逆时针方向 根据双倍面积的符号判断方向
是否逆时针方向
清除扩展数据
检查是否有扩展数据
是否存在扩展数据
从默认属性对象复制属性
将指定的默认属性对象的所有相关属性复制到当前实体。 这通常用于创建新实体时应用默认设置。
默认属性对象,包含layer、colorIndex、lineType等属性
当前实例(支持链式调用)
显式标记本实体克隆自哪个图纸中的哪个实体
generateCloneObjectId 依赖 Engine.currentDoc.serverSource,编程式成图时
当前文档往往不是克隆来源,需要用这个方法直接指定。
导出 DWG 时后端据此从源图做 ODA 克隆,只把发生变化的属性覆盖上去, 未改动的字体、线型和填充图案保持源实体原样。
源实体在 DWG 中的 handle
Optionalmapid: string源图 mapid;省略表示克隆自当前文档的 templateFrom 模板
源图版本,默认 "v1"
设置为系统默认值
从全局CAD系统设置中获取当前的默认属性值并应用到实体。 这些默认值包括当前图层、当前颜色、当前线型等。
使用的全局变量:
从数据库默认属性对象设置属性
从数据库查询结果或序列化数据中恢复实体属性。 这个方法处理数据库中可能存在的空值和默认值情况。
数据库属性对象,包含layerId、colorIndex等属性
当前实例(支持链式调用)
将属性映射到数据库默认属性对象
将当前实体的属性映射到数据库存储格式的对象中。 用于保存实体数据到数据库或序列化。
目标数据库属性对象
映射后的属性对象
释放实体占用的外部资源 子类如持有 PIXI 对象或大尺寸缓冲,应覆盖此方法清理
设置拟合点(替换现有点) 曲线将精确经过所有拟合点,内部自动计算控制点和节点向量
拟合点坐标数组 [[x, y], ...],至少 2 个
Optionaloptions: FitPointsOptions可选参数:参数化方式、起/终切线
this,支持链式调用
添加单个拟合点并重新计算曲线
坐标 [x, y]
Optionaloptions: FitPointsOptions可选参数
this,支持链式调用
批量添加拟合点并重新计算曲线
拟合点数组 [[x, y], ...]
Optionaloptions: FitPointsOptions可选参数
this,支持链式调用
获取指定索引的拟合点坐标
索引(0-based)
[x, y] 坐标数组
获取所有拟合点坐标
[[x, y], ...] 坐标数组
镜像操作 沿指定轴线镜像样条曲线
镜像轴起点
镜像轴终点
拉伸操作 在指定拉伸框内的控制点会被移动
起始点
目标点
拉伸框对象
清除几何缓存
重写 setModified 以清除几何缓存
获取边界框 计算包含所有实体的最小边界框
坐标系类型,默认为WCS
边界框
样条曲线类 表示NURBS样条曲线,支持控制点和拟合点定义
Example