XDrxAPI 21 个 INSERT 函数帮助文档
1函数名称: xdrx-insert-appendattribute
描述:
将文字/文字转换为块属性并附加到块参照
调用格式:
(xdrx-insert-appendattribute <块参照> <文字/选择集> [属性标签])
参数说明:
* <块参照>: 目标块参照实体(ENAME)
* <文字/选择集>: 文字实体或选择集(ENAME/RTPICKS)
* [属性标签]: 可选，新属性的标签(STR)
返回值:
新创建的属性实体列表
示例用法1:
(xdrx-insert-appendattribute blk txt)
; 将文字对象转换为块属性
示例用法2:
(xdrx-insert-appendattribute blk (ssget) "TAG1")
; 将选择集中的文字转换为带标签的属性
注意事项:
1. 原文字对象会被删除
2. 支持普通文字和文字对象
3. 属性会继承原文字的内容和样式
------------------------------------------------------------
2
函数名称: xdrx-insert-appendwipeout
描述:
为块参照添加遮罩区域
调用格式:
(xdrx-insert-appendwipeout <块参照/选择集> [偏移值])
参数说明:
* <块参照/选择集>: 目标块参照实体或选择集(ENAME/RTPICKS)
* : 可选，T表示使用块边界，或指定点列表定义边界
* [偏移值]: 可选，边界偏移量(INT/REAL)
返回值:
成功返回T
示例用法1:
(xdrx-insert-appendwipeout blk)
; 为块参照添加默认遮罩
示例用法2:
(xdrx-insert-appendwipeout (ssget) T 5.0)
; 为选择集中的块添加带5单位偏移的边界遮罩
注意事项:
1. 不指定边界时自动计算合适遮罩区域
2. 偏移值为正时向外偏移，为负时向内偏移
3. 会删除原有的遮罩对象
------------------------------------------------------------
3
函数名称: xdrx-insert-blocktablerecord
描述:
获取块参照对应的块表记录
调用格式:
(xdrx-insert-blocktablerecord <块参照>)
参数说明:
* <块参照>: 目标块参照实体(ENAME)
返回值:
包含块名和块表记录实体的列表
示例用法1:
(xdrx-insert-blocktablerecord blk)
; 获取块参照对应的块表记录
注意事项:
1. 返回值为(块名 块表记录实体)的列表
2. 可用于获取块定义信息
3. 块表记录实体可用于进一步操作块定义
------------------------------------------------------------
4
函数名称: xdrx-insert-blocktransform
描述:
获取块参照的变换矩阵
调用格式:
(xdrx-insert-blocktransform <块参照>)
参数说明:
* <块参照>: 目标块参照实体(ENAME)
返回值:
块变换矩阵数据列表
示例用法1:
(xdrx-insert-blocktransform blk)
; 获取块参照的变换矩阵
注意事项:
1. 变换矩阵包含块的位置、旋转和缩放信息
2. 可用于计算块内实体在世界坐标系中的位置
3. 返回值为16个元素的变换矩阵数据
------------------------------------------------------------
5
函数名称: xdrx-insert-box
描述:
获取块参照的边界框
调用格式:
(xdrx-insert-box <块参照>)
参数说明:
* <块参照>: 目标块参照实体(ENAME)
返回值:
包含最小点和最大点的列表
示例用法1:
(xdrx-insert-box blk)
; 获取块参照的边界框
注意事项:
1. 返回值为(minPoint maxPoint)的列表
2. 边界框为世界坐标系下的范围
3. 可用于计算块参照的尺寸和位置
------------------------------------------------------------
6
函数名称: xdrx-insert-clip
描述:
为块参照或外部参照创建裁剪边界
调用格式:
(xdrx-insert-clip <块参照/外部参照> [裁剪边界] )
参数说明:
* <块参照/外部参照>: 目标实体(ENAME)
* [裁剪边界]: 可选，多段线实体或点列表定义边界
* : 可选，反转裁剪区域
返回值:
成功返回T
示例用法1:
(xdrx-insert-clip blk)
; 为块参照创建默认裁剪边界
示例用法2:
(xdrx-insert-clip xref pline T)
; 使用多段线创建反转的裁剪边界
注意事项:
1. 不指定边界时自动计算合适裁剪区域
2. 裁剪边界必须闭合
3. 反转参数T可显示裁剪区域外的部分
------------------------------------------------------------
7
函数名称: xdrx-insert-getattribs
描述:
获取块参照中的属性实体列表
调用格式:
(xdrx-insert-getattribs <块参照>)
参数说明:
* <块参照>: 目标块参照实体(ENAME)
返回值:
属性实体列表
示例用法1:
(xdrx-insert-getattribs blk)
; 获取块参照中的所有属性实体
注意事项:
1. 仅返回块参照中的属性实体
2. 返回的实体列表可直接用于属性编辑
3. 不包含常量属性
------------------------------------------------------------
8
函数名称: xdrx-insert-getclipinfo
描述:
获取块参照或外部参照的裁剪信息
调用格式:
(xdrx-insert-getclipinfo <块参照/外部参照> [信息类型])
参数说明:
* <块参照/外部参照>: 目标实体(ENAME)
* [信息类型]: 可选，指定返回的信息类型(STR)
返回值:
裁剪信息列表或指定信息
示例用法1:
(xdrx-insert-getclipinfo blk)
; 获取块参照的所有裁剪信息
示例用法2:
(xdrx-insert-getclipinfo xref "BoundBox")
; 获取外部参照的裁剪边界框
注意事项:
1. 信息类型可选值包括："BoundBox"、"Vertexs"、"Normal"、"Volume"等
2. 不指定信息类型时返回完整裁剪信息列表
3. 仅对有裁剪的块参照/外部参照有效
------------------------------------------------------------
9
函数名称: xdrx-insert-hasattribute
描述:
检查块参照是否包含指定属性
调用格式:
(xdrx-insert-hasattribute <块参照> <属性标签>)
参数说明:
* <块参照>: 目标块参照实体(ENAME)
* <属性标签>: 要检查的属性标签(STR)
返回值:
存在则返回属性实体，否则返回nil
示例用法1:
(xdrx-insert-hasattribute blk "TAG1")
; 检查块参照是否包含TAG1属性
注意事项:
1. 属性标签区分大小写
2. 仅检查可见属性
3. 返回的属性实体可直接用于后续操作
------------------------------------------------------------
10
函数名称: xdrx-insert-info
描述:
获取块参照的详细信息
调用格式:
(xdrx-insert-info <块参照>)
参数说明:
* <块参照>: 目标块参照实体(ENAME)
返回值:
包含块参照详细信息的关联列表
示例用法1:
(xdrx-insert-info blk)
; 获取块参照的详细信息
注意事项:
1. 返回信息包括块名、位置、旋转角度、缩放比例等
2. 边界框为世界坐标系下的范围
3. 变换矩阵可用于坐标转换
------------------------------------------------------------
11
函数名称: xdrx-insert-isclip
描述:
检查块参照或外部参照是否有裁剪边界
调用格式:
(xdrx-insert-isclip <块参照/外部参照>)
参数说明:
* <块参照/外部参照>: 目标实体(ENAME)
返回值:
有裁剪返回T，否则返回nil
示例用法1:
(xdrx-insert-isclip blk)
; 检查块参照是否有裁剪边界
示例用法2:
(xdrx-insert-isclip xref)
; 检查外部参照是否有裁剪边界
注意事项:
1. 仅检查是否存在裁剪边界，不返回具体信息
2. 如需获取裁剪详细信息，请使用xdrx-insert-getclipinfo
------------------------------------------------------------
12
函数名称: xdrx-insert-make
描述:
创建块参照
调用格式:
(xdrx-insert-make <块名> <插入点> [缩放比例] [旋转角度])
参数说明:
* <块名>: 块定义名称或DWG文件路径(STR)
* <插入点>: 插入位置(POINT/POINT)
* [缩放比例]: 可选，X/Y/Z方向缩放比例
* [旋转角度]: 可选，旋转角度(弧度)
返回值:
创建的块参照实体名
示例用法1:
(xdrx-insert-make "BLOCK1" '(0 0 0))
; 在原点创建BLOCK1块参照
示例用法2:
(xdrx-insert-make "C:/blocks/example.dwg" '(100 100) 2.0 (/ pi 4))
; 从DWG文件创建块参照，缩放2倍，旋转45度
注意事项:
1. 块名可以是当前图形中的块定义或外部DWG文件
2. 缩放比例可以是单个值(统一缩放)或点表(XYZ分别缩放)
3. 旋转角度单位为弧度
------------------------------------------------------------
13
函数名称: xdrx-insert-normal
描述:
获取块参照的法线向量
调用格式:
(xdrx-insert-normal <块参照>)
参数说明:
* <块参照>: 目标块参照实体(ENAME)
返回值:
法线向量(三维点表)
示例用法1:
(xdrx-insert-normal blk)
; 获取块参照的法线向量
注意事项:
1. 法线向量表示块参照的朝向
2. 默认法线为(0 0 1)表示XY平面
3. 返回值可直接用于几何计算
------------------------------------------------------------
14
函数名称: xdrx-insert-position
描述:
获取块参照的插入点位置
调用格式:
(xdrx-insert-position <块参照>)
参数说明:
* <块参照>: 目标块参照实体(ENAME)
返回值:
插入点坐标(三维点表)
示例用法1:
(xdrx-insert-position blk)
; 获取块参照的插入点位置
注意事项:
1. 返回值为世界坐标系下的坐标
2. 对于嵌套块，返回的是在当前空间的插入点
3. 返回值可直接用于几何计算
------------------------------------------------------------
15
函数名称: xdrx-insert-removeclip
描述:
移除块参照或外部参照的裁剪边界
调用格式:
(xdrx-insert-removeclip <块参照/外部参照>)
参数说明:
* <块参照/外部参照>: 目标实体(ENAME)
返回值:
成功返回T，否则返回nil
示例用法1:
(xdrx-insert-removeclip blk)
; 移除块参照的裁剪边界
示例用法2:
(xdrx-insert-removeclip xref)
; 移除外部参照的裁剪边界
注意事项:
1. 仅移除裁剪边界，不影响块参照本身
2. 操作成功后块参照将显示完整内容
3. 需要编辑权限才能执行此操作
------------------------------------------------------------
16
函数名称: xdrx-insert-removewipeout
描述:
移除块定义或块参照中的遮罩对象
调用格式:
(xdrx-insert-removewipeout <块名/块参照>)
参数说明:
* <块名/块参照>: 块定义名称或块参照实体(STR/ENAME)
返回值:
成功返回T，否则返回nil
示例用法1:
(xdrx-insert-removewipeout "BLOCK1")
; 移除BLOCK1块定义中的遮罩对象
示例用法2:
(xdrx-insert-removewipeout blkref)
; 移除块参照及其块定义中的遮罩对象
注意事项:
1. 可接受块名或块参照实体作为参数
2. 会同时更新所有关联的块参照
3. 需要编辑权限才能执行此操作
------------------------------------------------------------
17
函数名称: xdrx-insert-reset-origin
描述:
重置块参照的插入原点，保持块的实际位置不变
调用格式:
(xdrx-insert-reset-origin <块参照> <新原点>)
参数说明:
* <块参照>: 目标块参照实体(ENAME)
* <新原点>: 新的插入原点位置(POINT/POINT)
返回值:
成功返回T，否则返回nil
示例用法1:
(xdrx-insert-reset-origin blk '(100 100 0))
; 将块参照的插入原点重置到(100 100 0)，同时保持块的实际位置不变
注意事项:
1. 新原点坐标为世界坐标系下的点
2. 操作会调整块定义使块参照的实际位置保持不变
3. 需要编辑权限才能执行此操作
4. 适用于需要重新定义块插入点但不希望移动块位置的场景
------------------------------------------------------------
18
函数名称: xdrx-insert-rotation
描述:
获取块参照的旋转角度
调用格式:
(xdrx-insert-rotation <块参照>)
参数说明:
* <块参照>: 目标块参照实体(ENAME)
返回值:
旋转角度(弧度)
示例用法1:
(xdrx-insert-rotation blk)
; 获取块参照的旋转角度
注意事项:
1. 返回值为弧度制，范围0~2π
2. 角度相对于世界坐标系X轴
3. 对于嵌套块，返回的是在当前空间的旋转角度
------------------------------------------------------------
19
函数名称: xdrx-insert-scalefactors
描述:
获取块参照在X/Y/Z三个方向的缩放比例因子
调用格式:
(xdrx-insert-scalefactors <块参照>)
参数说明:
* <块参照>: 目标块参照实体(ENAME)
返回值:
包含X/Y/Z三个方向缩放比例因子的列表(sx sy sz)
示例用法1:
(xdrx-insert-scalefactors blk)
; 获取块参照的缩放比例，如(1.0 1.0 1.0)
示例用法2:
(setq scales (xdrx-insert-scalefactors blk))
; 将缩放比例存入变量scales
注意事项:
1. 返回值为三个实数组成的列表
2. 对于统一缩放块，三个值相同
3. 比例因子1.0表示原始大小
------------------------------------------------------------
20
函数名称: xdrx-minsert-make
描述:
创建矩形阵列块参照(多重插入块)
调用格式:
(xdrx-minsert-make <块名/块参照> <插入点> <缩放比例> <旋转角度> <行数> <列数> <行间距> <列间距>)
参数说明:
* <块名/块参照>: 块定义名称或块参照实体(STR/ENAME)
* <插入点>: 阵列的基准点位置(POINT)
* <缩放比例>: 整体缩放比例因子(REAL/INT)
* <旋转角度>: 整体旋转角度(弧度)(REAL/INT)
* <行数>: 行数量(INT)
* <列数>: 列数量(INT)
* <行间距>: 行间距值(REAL/INT)
* <列间距>: 列间距值(REAL/INT)
返回值:
成功返回创建的阵列块参照实体名，否则返回nil
示例用法1:
(xdrx-minsert-make "BLOCK1" '(0 0 0) 1.0 0.0 3 5 100.0 150.0)
; 创建3行5列的BLOCK1阵列块，间距100x150
示例用法2:
(xdrx-minsert-make blkref '(100 100 0) 0.5 (/ pi 4) 2 2 200.0 200.0)
; 创建2x2阵列，旋转45度，缩放0.5倍
注意事项:
1. 所有参数都是必须的
2. 旋转角度使用弧度制
3. 间距值为实际距离，不受缩放比例影响
4. 返回的实体可作为单个块参照操作
------------------------------------------------------------
21
函数名称: xdrx-minsert-explode
描述:
分解多重插入块为独立块参照
调用格式:
(xdrx-minsert-explode <多重插入块/选择集> )
参数说明:
* <多重插入块/选择集>: 目标多重插入块实体或选择集(ENAME/RTPICKS)
* : 可选参数，指定时删除原多重插入块(RTT)
返回值:
分解后的块参照选择集
示例用法1:
(xdrx-minsert-explode mblock)
; 分解多重插入块，保留原块
示例用法2:
(xdrx-minsert-explode mblock T)
; 分解多重插入块并删除原块
示例用法3:
(xdrx-minsert-explode (ssget "X" '((0 . "MINSERT")) T)
; 分解所有多重插入块并删除原块
注意事项:
1. 分解后每个块参照变为独立实体
2. 不指定T参数时保留原多重插入块
3. 返回的选择集包含所有分解后的块参照
------------------------------------------------------------
页:
[1]