在 AutoLISP 中,entmake 函数创建图元的核心在于构建一个符合 DXF(Drawing Exchange Format)标准的关联表(Association List) 。该列表由若干组 (组码 . 值) 或 (组码 值 值 值) 的点对组成,其中组码 0 决定了要创建的图元类型。
以下是常用图元的 DXF 组码列表结构详解及代码实现:
1. 核心图元类型与关键组码对照表
所有图元必须包含 0 (类型)、 8 (图层) 和 100 (子类标记,高版本 CAD 必需)。坐标类数据通常使用组码 10 (起点/插入点),部分图元需要 11 (终点)、 40 (半径/高度) 等特定参数 。
| 图元类型 | DXF 名称 (组码 0) | 必需关键组码 | 数据含义说明 |
|---|---|---|---|
| 直线 | "LINE" |
` | |
10, |
|||
| 11` | ` | ||
10: 起点 XYZ; |
|||
| 11`: 终点 XYZ | |||
| 圆 | "CIRCLE" |
` | |
10, |
|||
| 40` | ` | ||
10: 圆心 XYZ; |
|||
| 40`: 半径 | |||
| 圆弧 | "ARC" |
` | |
10, |
|||
40, |
|||
50, |
|||
| 51` | ` | ||
10: 圆心; |
|||
40: 半径; |
|||
50: 起始角; |
|||
| 51`: 终止角 (弧度) | |||
| 多段线 | "LWPOLYLINE" |
` | |
10, |
|||
90, |
|||
| 70` | ` | ||
90: 顶点数; |
|||
70: 标志位 (1=闭合); |
|||
| 10`: 每个顶点的坐标 (需重复) | |||
| 文字 | "TEXT" |
` | |
10, |
|||
11, |
|||
40, |
|||
| 1` | ` | ||
1: 内容字符串; |
|||
40: 字高; |
|||
10: 插入点; |
|||
| 11`: 对齐点 | |||
| 多行文字 | "MTEXT" |
` | |
10, |
|||
40, |
|||
1, |
|||
| 71` | ` | ||
1: 内容; |
|||
40: 字高; |
|||
71: 附着点; |
|||
| 72`: 绘制方向 | |||
| 块参照 | "INSERT" |
` | |
2, |
|||
| 10` | ` | ||
2: 块名; |
|||
10: 插入点; |
|||
41/ |
|||
42: X/Y 比例; |
|||
| 50`: 旋转角 | |||
| 尺寸标注 | "DIMENSION" |
` | |
2, |
|||
10, |
|||
11, |
|||
| 12` | ` | ||
2: 样式名; |
|||
10: 定义点; |
|||
11: 文本位置; |
|||
12: 测量点 (较复杂,通常建议用 command` 或专用库) |
图层定义 | "LAYER" |
|
2, |
|||
70, |
|||
| 62` | ` | ||
2: 图层名; |
|||
70: 标志位; |
|||
| 62`: 颜色索引 (用于创建图层表记录) |
注意 :组码
100是子类标记(如"AcDbEntity","AcDbLine"),在 AutoCAD 2000 及以上版本中,为了保证数据完整性和兼容性,建议在组码0之后显式添加 。
2. 各类图元创建代码示例
以下代码展示了如何构造不同图元的 DXF 列表并调用 entmake。所有坐标均采用 (x y z) 格式,角度均为弧度制。
2.1 基础线性图元(直线、圆、圆弧)
lisp
(defun c:MakeBasicPrimitives () ;; 1. 创建直线 (LINE)
(entmake
'(
(0 . "LINE")
(100 . "AcDbEntity") ; 子类标记
(100 . "AcDbLine")
(8 . "0") ; 图层
(10 0.0 0.0 0.0) ; 起点
(11 100.0 0.0 0.0) ; 终点
)
)
;; 2. 创建圆 (CIRCLE)
(entmake
'(
(0 . "CIRCLE")
(100 . "AcDbEntity")
(100 . "AcDbCircle")
(8 . "0")
(10 50.0 50.0 0.0) ; 圆心
(40 . 25.0) ; 半径
)
)
;; 3. 创建圆弧 (ARC) - 角度需转换为弧度 (pi = 3.14159...)
;; 从 0 度到 90 度 (0 到 pi/2)
(entmake
'(
(0 . "ARC")
(100 . "AcDbEntity")
(100 . "AcDbArc")
(8 . "0")
(10 150.0 50.0 0.0) ; 圆心
(40 . 25.0) ; 半径
(50 . 0.0) ; 起始角 (弧度)
(51 . 1.5708) ; 终止角 (弧度,约 90 度)
)
)
(princ "
基础线性图元创建完成。")
)
2.2 轻量多段线 (LWPOLYLINE)
轻量多段线是二维绘图最常用的对象,其顶点坐标通过重复组码 10 来定义,且必须在头部声明顶点数量(组码 90)。
lisp
(defun c:MakeLWPolyline ()
(setq pt1 '(0.0 100.0 0.0))
(setq pt2 '(50.0 150.0 0.0))
(setq pt3 '(100.0 100.0 0.0))
(setq pt4 '(50.0 50.0 0.0))
;; 构建顶点列表数据
;; 注意:LWPOLYLINE 只需要 X, Y 坐标,Z 坐标通常忽略或由标高决定
(entmake
(list
'(0 . "LWPOLYLINE")
'(100 . "AcDbEntity")
'(100 . "AcDbPolyline")
'(8 . "0")
'(90 . 4) ; 顶点数量
'(70 . 1) ; 标志位:1=闭合多段线,0=开放
'(43 . 0.0) ; 全局宽度 (可选)
(cons 10 pt1) ; 顶点 1
(cons 10 pt2) ; 顶点 2
(cons 10 pt3) ; 顶点 3
(cons 10 pt4) ; 顶点 4
)
)
(princ "
闭合多段线创建完成。")
)
2.3 文字与块参照 (TEXT & INSERT)
文字对象需要注意对齐点(组码 11)与插入点(组码 10)的关系,块参照则需要指定已定义的块名 。
lisp
(defun c:MakeTextAndBlock ()
;; 1. 创建单行文字 (TEXT)
(entmake
(list
'(0 . "TEXT")
'(100 . "AcDbEntity")
'(100 . "AcDbText")
(cons 1 "Hello CAD") ; 组码 1: 文字内容
'(8 . "0")
(cons 10 '(200.0 200.0 0.0)) ; 插入点
'(40 . 5.0) ; 字高
'(50 . 0.0) ; 旋转角度 (弧度)
'(41 . 1.0) ; 宽度比例
'(71 . 0) ; 文字生成标志
'(72 . 0) ; 水平对齐 (0=左)
(cons 11 '(200.0 200.0 0.0)) ; 对齐点 (若左对齐,通常与 10 相同)
'(73 . 0) ; 垂直对齐 (0=基线) '(210 0.0 0.0 1.0) ; 挤出方向 (法向量)
)
)
;; 2. 创建块参照 (INSERT)
;; 假设图中已存在名为 "MyBlock" 的块定义
(entmake
(list
'(0 . "INSERT")
'(100 . "AcDbEntity")
'(100 . "AcDbBlockReference")
(cons 2 "MyBlock") ; 组码 2: 块名称
'(8 . "0")
(cons 10 '(300.0 200.0 0.0)) ; 插入点
'(41 . 1.0) ; X 比例因子
'(42 . 1.0) ; Y 比例因子
'(43 . 1.0) ; Z 比例因子
'(50 . 0.0) ; 旋转角度
'(70 . 0) ; 列数
'(71 . 0) ; 行数
'(44 . 0.0) ; 列间距
'(45 . 0.0) ; 行间距
)
)
(princ "
文字与块参照创建完成。")
)
3. 数据结构构建技巧
在实际编程中,手动书写 '(...) 列表较为繁琐且不易动态修改。通常使用 list 和 cons 函数动态构建 DXF 表,特别是处理变量坐标时 。
lisp
(defun c:DynamicPointCreator (startPt endPt layerName)
;; 动态构建直线 DXF 表
;; 使用 cons 将变量嵌入列表
(entmake
(list
'(0 . "LINE")
'(100 . "AcDbEntity")
'(100 . "AcDbLine")
(cons 8 layerName) ; 动态图层名
(cons 10 startPt) ; 动态起点 (例如:(getpoint))
(cons 11 endPt) ; 动态终点 '(62 . 2) ; 颜色:黄色
)
)
)
;; 调用示例:
;; (c:DynamicPointCreator '(00 0) '(50 50 0) "WALLS")
关键逻辑说明:
- 组码 0 是入口,决定了后续哪些组码是合法的。
- 组码 100 虽然在某些旧版 CAD 中可省略,但在现代 ObjectARX 架构下,缺失子类标记可能导致
entmake失败或创建出"代理对象",因此必须包含 。 - 坐标系统 :
entmake写入的是数据库绝对坐标(通常是 WCS),不受当前 UCS 影响,这与command函数有本质区别。