XDrxAPI 17 个 Region 函数帮助手册
1函数名称: xdrx-region->curves
描述:
将面域转换为曲线实体（多段线/样条曲线等）
调用格式:
(xdrx-region->curves <面域或选择集> [模式] )
参数说明:
* <面域或选择集>: 目标面域实体(RTENAME)或选择集(RTPICKS)
* [模式]: 可选参数(RTSHORT)，转换模式：
- 0: 基本模式
- 1: 优化模式（默认）
- 2: 高级模式
* : 可选参数(RTT)，保留原面域
返回值:
返回转换后的曲线实体列表
示例用法1:
(xdrx-region->curves ent)
; 将面域转换为曲线（优化模式）
示例用法2:
(xdrx-region->curves (ssget) 2 T)
; 批量转换并保留原面域（高级模式）
注意事项:
1. 自动处理闭合多段线
2. 继承原面域属性
3. 默认删除原面域
4. 支持批量处理选择集
5. 转换失败自动跳过
------------------------------------------------------------
2
函数名称: xdrx-region->hatch
描述:
将面域转换为填充图案
调用格式:
(xdrx-region->hatch <面域或选择集> )
参数说明:
* <面域或选择集>: 目标面域实体(RTENAME)或选择集(RTPICKS)
* : 可选参数(RTT)，保留原面域
返回值:
返回创建的填充图案实体，失败返回nil
示例用法1:
(xdrx-region->hatch ent)
; 将面域转换为填充并删除原面域
示例用法2:
(xdrx-region->hatch (ssget) T)
; 批量转换并保留原面域
注意事项:
1. 自动继承面域边界
2. 默认删除原面域
3. 支持批量处理选择集
4. 转换失败自动跳过
5. 创建的填充使用当前默认设置
------------------------------------------------------------
3
函数名称: xdrx-region->list
描述:
将面域转换为几何实体列表（曲线或多段线）
调用格式:
(xdrx-region->list <面域实体> )
参数说明:
* <面域实体>: 目标面域实体(RTENAME)
* : 可选参数(RTT)，强制转换为多段线
返回值:
成功返回几何实体列表，失败返回NIL
示例用法1:
(xdrx-region->list ent)
; 获取面域的几何曲线列表
示例用法2:
(xdrx-region->list ent T)
; 获取转换为多段线的列表
注意事项:
1. 默认返回原始几何曲线
2. T参数强制转换为多段线
3. 不创建实际图形实体
4. 仅支持单个面域输入
5. 复合曲线保持原样
------------------------------------------------------------
4
函数名称: xdrx-region->mpolygon
描述:
将面域转换为多段面域(MPolygon)实体
调用格式:
(xdrx-region->mpolygon <面域或选择集> )
参数说明:
* <面域或选择集>: 目标面域实体(RTENAME)或选择集(RTPICKS)
* : 可选参数(RTT)，保留原面域
返回值:
返回创建的多段面域实体，失败返回nil
示例用法1:
(xdrx-region->mpolygon ent)
; 转换面域并删除原实体
示例用法2:
(xdrx-region->mpolygon (ssget) T)
; 批量转换并保留原面域
注意事项:
1. 自动继承原面域属性
2. 默认删除原面域
3. 支持批量处理选择集
4. 转换失败自动跳过
5. 返回单个合并后的多段面域
------------------------------------------------------------
5
函数名称: xdrx-region->polyline
描述:
将填充图案转换为闭合多段线
调用格式:
(xdrx-region->polyline <填充或选择集> )
参数说明:
* <填充或选择集>: 目标填充实体(RTENAME)或选择集(RTPICKS)
* : 可选参数(RTT)，保留原填充
返回值:
返回创建的多段线实体列表，失败返回nil
示例用法1:
(xdrx-region->polyline ent)
; 转换填充为多段线并删除原填充
示例用法2:
(xdrx-region->polyline (ssget) T)
; 批量转换并保留原填充
注意事项:
1. 自动创建闭合多段线
2. 默认删除原填充
3. 支持批量处理选择集
4. 转换失败自动跳过
5. 继承原填充属性
------------------------------------------------------------
6
函数名称: xdrx-region->spline
描述:
将面域转换为样条曲线实体
调用格式:
(xdrx-region->spline <面域或选择集> )
参数说明:
* <面域或选择集>: 目标面域实体(RTENAME)或选择集(RTPICKS)
* : 可选参数(RTT)，保留原面域
返回值:
返回创建的样条曲线实体列表，失败返回nil
示例用法1:
(xdrx-region->spline ent)
; 将面域转换为样条曲线并删除原面域
示例用法2:
(xdrx-region->spline (ssget) T)
; 批量转换并保留原面域
注意事项:
1. 自动处理多环面域
2. 默认删除原面域
3. 支持批量处理选择集
4. 转换失败自动跳过
5. 继承原面域属性
------------------------------------------------------------
7
函数名称: xdrx-region-area
描述:
获取面域的面积值
调用格式:
(xdrx-region-area <面域实体>)
参数说明:
* <面域实体>: 目标面域实体(RTENAME)
返回值:
返回面域的面积值(实数)，失败返回nil
示例用法:
(xdrx-region-area ent)
; 获取指定面域的面积
注意事项:
1. 仅支持单个面域输入
2. 返回值为当前单位下的面积
3. 非面域实体返回nil
4. 不支持选择集输入
------------------------------------------------------------
8
函数名称: xdrx-region-booleanoper
描述:
对两个面域执行布尔运算（并集/交集/差集）
调用格式:
(xdrx-region-booleanoper <面域1> <面域2> [运算模式])
参数说明:
* <面域1>: 第一个面域实体(RTENAME)
* <面域2>: 第二个面域实体(RTENAME)
* [运算模式]: 可选参数(RTSHORT)
- 0: 并集（默认）
- 1: 交集
- 2: 差集（面域1减去面域2）
返回值:
返回运算后的面域实体，失败返回nil
示例用法1:
(xdrx-region-booleanoper ent1 ent2)
; 对两个面域执行并集运算
示例用法2:
(xdrx-region-booleanoper ent1 ent2 2)
; 执行差集运算（ent1减去ent2）
注意事项:
1. 运算结果保存在面域1中
2. 相同面域将返回nil
3. 非面域实体将返回nil
4. 不支持选择集输入
------------------------------------------------------------
9
函数名称: xdrx-hatch-detach
描述:
将填充图案分离为独立区域
调用格式:
(xdrx-hatch-detach <填充或选择集>)
参数说明:
* <填充或选择集>: 目标填充实体(RTENAME)或选择集(RTPICKS)
返回值:
返回分离后的区域实体列表，失败返回nil
示例用法1:
(xdrx-hatch-detach ent)
; 将填充分离为独立区域
示例用法2:
(xdrx-hatch-detach (ssget))
; 批量分离多个填充
注意事项:
1. 自动处理多区域填充
2. 保留原填充属性
3. 支持批量处理选择集
4. 转换失败自动跳过
5. 返回多个区域实体
------------------------------------------------------------
10
函数名称: xdrx-hatch-getplane
描述:
获取填充图案的平面坐标系参数
调用格式:
(xdrx-hatch-getplane <填充实体> )
参数说明:
* <填充实体>: 目标填充实体(RTENAME)
* : 可选参数(RTT)，返回完整坐标系
返回值:
成功返回平面参数列表，失败返回nil
- 默认返回(原点 法向量)
- 带T参数返回(原点 X轴 Y轴)
示例用法1:
(xdrx-hatch-getplane ent)
; 获取填充平面的原点和法向量
示例用法2:
(xdrx-hatch-getplane ent T)
; 获取填充平面的完整坐标系
注意事项:
1. 仅支持单个填充输入
2. 返回值为WCS坐标系
3. 非填充实体返回nil
4. 不支持选择集输入
------------------------------------------------------------
11
函数名称: xdrx-region-info
描述:
获取面域/曲线的几何属性信息
调用格式:
(xdrx-region-info <实体或点列表>)
参数说明:
* <实体或点列表>: 目标实体(RTENAME)或点列表(RT3DPOINT)
返回值:
返回属性列表，包含：
- 周长(Perimeter)
- 面积(Area)
- 质心(Centroid)
- 惯性矩(MomInertia)
- 惯性积(ProdInertia)
- 主惯性矩(PrinMoments)
- 主轴方向(PrinAxes)
- 回转半径(RadGyration)
- 包围盒(Box)
示例用法1:
(xdrx-region-info ent)
; 获取面域的几何属性
示例用法2:
(xdrx-region-info (list pt1 pt2 pt3))
; 获取由点列表构成的多边形的几何属性
注意事项:
1. 支持实体或点列表输入
2. 返回值为UCS坐标系
3. 点列表需构成闭合多边形
4. 非面域/曲线实体可能返回错误
------------------------------------------------------------
12
函数名称: xdrx-region-intersect
描述:
计算两个面域的交集区域
调用格式:
(xdrx-region-intersect <面域1> <面域2>)
参数说明:
* <面域1>: 第一个面域实体(RTENAME)
* <面域2>: 第二个面域实体(RTENAME)
返回值:
返回交集面域实体，失败返回nil
示例用法:
(xdrx-region-intersect ent1 ent2)
; 计算两个面域的交集
注意事项:
1. 运算结果保存在面域1中
2. 相同面域将返回nil
3. 非面域实体将返回nil
4. 无交集时返回nil
5. 不支持选择集输入
------------------------------------------------------------
13
函数名称: xdrx-region-make
描述:
创建面域实体（支持多种输入方式和布尔运算）
调用格式:
(xdrx-region-make [实体/选择集/点列表] [运算模式])
参数说明:
* [实体/选择集/点列表]: 可选输入(RTENAME/RTPICKS/RT3DPOINT)
- 实体: 曲线实体
- 选择集: 包含曲线实体的选择集
- 点列表: 构成闭合多边形的点列表
* : 可选参数(RTT)，保留原实体
* [运算模式]: 可选参数(RTSHORT)
- 0: 并集（默认）
- 1: 分解为多个面域
- 2: 转换为多段线
- 3: 差集运算
返回值:
返回创建的面域实体或列表，失败返回nil
示例用法1:
(xdrx-region-make)
; 创建空面域
示例用法2:
(xdrx-region-make (ssget) T 1)
; 从选择集创建并分解为多个面域
注意事项:
1. 无参数时创建空面域
2. 支持曲线实体、选择集和点列表输入
3. 默认删除原实体（加T保留）
4. 支持多种布尔运算模式
5. 自动处理自相交情况
------------------------------------------------------------
14
函数名称: xdrx-region-numchanges
描述:
获取面域的修改次数统计
调用格式:
(xdrx-region-numchanges <面域实体>)
参数说明:
* <面域实体>: 目标面域实体(RTENAME)
返回值:
返回面域的修改次数(整数)
示例用法:
(xdrx-region-numchanges ent)
; 获取指定面域的修改次数
注意事项:
1. 仅支持单个面域输入
2. 返回值为累计修改次数
3. 非面域实体返回nil
4. 不支持选择集输入
------------------------------------------------------------
15
函数名称: xdrx-region-subtract
描述:
对两个面域执行差集运算（面域1减去面域2）
调用格式:
(xdrx-region-subtract <面域1> <面域2>)
参数说明:
* <面域1>: 第一个面域实体(RTENAME)
* <面域2>: 第二个面域实体(RTENAME)
返回值:
返回运算后的面域实体，失败返回nil
示例用法:
(xdrx-region-subtract ent1 ent2)
; 执行差集运算（ent1减去ent2）
注意事项:
1. 运算结果保存在面域1中
2. 相同面域将返回nil
3. 非面域实体将返回nil
4. 无交集时返回原面域1
5. 不支持选择集输入
------------------------------------------------------------
16
函数名称: xdrx-region-union
描述:
对多个面域执行并集运算
调用格式:
(xdrx-region-union <面域或选择集>...)
参数说明:
* <面域或选择集>: 多个面域实体(RTENAME)或选择集(RTPICKS)
返回值:
返回合并后的面域实体，失败返回nil
示例用法1:
(xdrx-region-union ent1 ent2 ent3)
; 合并三个面域
示例用法2:
(xdrx-region-union (ssget))
; 批量合并选择集中的面域
注意事项:
1. 需要至少两个面域输入
2. 运算结果保存在第一个面域中
3. 非面域实体将被忽略
4. 支持混合输入(实体+选择集)
5. 无交集时仍会合并
------------------------------------------------------------
17
函数名称: xdrx-region-vertex
描述:
获取面域的顶点坐标列表
调用格式:
(xdrx-region-vertex <面域实体> )
参数说明:
* <面域实体>: 目标面域实体(RTENAME)
* : 可选参数(RTT)，控制坐标转换
返回值:
返回顶点坐标列表，失败返回nil
示例用法:
(xdrx-region-vertex ent)
; 获取面域所有顶点坐标
注意事项:
1. 仅支持单个面域输入
2. 加T参数时进行UCS坐标转换
3. 非面域实体返回nil
4. 返回坐标顺序与面域创建顺序一致
5. 不支持选择集输入
------------------------------------------------------------
页:
[1]