XDSoft 发表于 2025-5-22 22:56:39

XDrxAPI 13 个 MPolygon 函数帮助手册

1
函数名称: xdrx-mpolygon->curve
函数别名: xdrx-mpolygon->polyline

描述:
将多段线多边形(MPolygon)转换为曲线实体

调用格式:
(xdrx-mpolygon->curve <MPolygon或选择集> )

参数说明:
* <MPolygon或选择集>: 目标MPolygon实体(RTENAME)或选择集(RTPICKS)
* : 可选参数(RTT),保留原实体

返回值:
返回转换后的曲线实体列表

示例用法1:
(xdrx-mpolygon->curve ent)
; 转换单个MPolygon为曲线

示例用法2:
(xdrx-mpolygon->curve (ssget) T)
; 批量转换选择集中的MPolygon并保留原实体

注意事项:
1. 默认删除原MPolygon实体(加T保留)
2. 支持单个实体或选择集输入
3. 转换结果保留原实体属性
4. 非MPolygon实体将被忽略
5. 返回曲线可直接用于绘图操作
------------------------------------------------------------
2
函数名称: xdrx-mpolygon->hatch

描述:
将多段线多边形(MPolygon)转换为填充图案(Hatch)

调用格式:
(xdrx-mpolygon->hatch <MPolygon或选择集> )

参数说明:
* <MPolygon或选择集>: 目标MPolygon实体(RTENAME)或选择集(RTPICKS)
* : 可选参数(RTT),保留原实体

返回值:
返回创建的填充图案实体ID,失败返回nil

示例用法1:
(xdrx-mpolygon->hatch ent)
; 转换单个MPolygon为填充图案

示例用法2:
(xdrx-mpolygon->hatch (ssget) T)
; 批量转换选择集中的MPolygon并保留原实体

注意事项:
1. 默认删除原MPolygon实体(加T保留)
2. 支持单个实体或选择集输入
3. 转换结果保留原实体边界
4. 非MPolygon实体将被忽略
5. 返回的填充图案可直接编辑
------------------------------------------------------------
3
函数名称: xdrx-mpolygon->list

描述:
获取多段线多边形(MPolygon)的几何数据列表

调用格式:
(xdrx-mpolygon->list <MPolygon实体>)

参数说明:
* <MPolygon实体>: 目标MPolygon实体(RTENAME)

返回值:
返回几何数据列表(包含环信息),失败返回nil

示例用法:
(xdrx-mpolygon->list ent)
; 获取MPolygon的几何数据

注意事项:
1. 仅支持单个MPolygon输入
2. 返回数据包含多边形环信息
3. 非MPolygon实体返回nil
4. 返回数据可用于几何分析
5. 不支持选择集输入
------------------------------------------------------------
4
函数名称: xdrx-mpolygon->region

描述:
将多段线多边形(MPolygon)转换为面域(Region)

调用格式:
(xdrx-mpolygon->region <MPolygon或选择集> )

参数说明:
* <MPolygon或选择集>: 目标MPolygon实体(RTENAME)或选择集(RTPICKS)
* : 可选参数(RTT),保留原实体

返回值:
返回转换后的面域实体,失败返回nil

示例用法1:
(xdrx-mpolygon->region ent)
; 转换单个MPolygon为面域

示例用法2:
(xdrx-mpolygon->region (ssget) T)
; 批量转换选择集中的MPolygon并保留原实体

注意事项:
1. 默认删除原MPolygon实体(加T保留)
2. 支持单个实体或选择集输入
3. 转换结果保留原实体属性
4. 非MPolygon实体将被忽略
5. 返回面域可直接用于布尔运算
------------------------------------------------------------
5
函数名称: xdrx-mpolygon-detach

描述:
分解多段线多边形(MPolygon)为组成边界

调用格式:
(xdrx-mpolygon-detach <MPolygon或选择集>)

参数说明:
* <MPolygon或选择集>: 目标MPolygon实体(RTENAME)或选择集(RTPICKS)

返回值:
返回分解后的边界实体列表,失败返回nil

示例用法1:
(xdrx-mpolygon-detach ent)
; 分解单个MPolygon为边界

示例用法2:
(xdrx-mpolygon-detach (ssget))
; 批量分解选择集中的MPolygon

注意事项:
1. 自动删除原MPolygon实体
2. 分解后的第一个实体继承原MPolygon的对象ID和所有属性
3. 支持单个实体或选择集输入
4. 非MPolygon实体将被忽略
5. 返回边界实体可直接编辑
------------------------------------------------------------
6
函数名称: xdrx-mpolygon-detachpattern

描述:
分离多段线多边形(MPolygon)的填充图案为独立实体

调用格式:
(xdrx-mpolygon-detachpattern <MPolygon或选择集>)

参数说明:
* <MPolygon或选择集>: 目标MPolygon实体(RTENAME)或选择集(RTPICKS)

返回值:
返回分离后的填充图案实体,失败返回nil

示例用法1:
(xdrx-mpolygon-detachpattern ent)
; 分离单个MPolygon的填充图案

示例用法2:
(xdrx-mpolygon-detachpattern (ssget))
; 批量分离选择集中的MPolygon填充图案

注意事项:
1. 自动创建新的MPolygon实体继承原属性
2. 支持单个实体或选择集输入
3. 保留原MPolygon的所有环信息
4. 非MPolygon实体将被忽略
5. 返回实体可直接用于图案编辑
------------------------------------------------------------
7
函数名称: xdrx-mpolygon-intersect

描述:
计算两个多段线多边形(MPolygon)的交集区域

调用格式:
(xdrx-mpolygon-intersect <MPolygon实体1> <MPolygon实体2>)

参数说明:
* <MPolygon实体1>: 第一个MPolygon实体(RTENAME)
* <MPolygon实体2>: 第二个MPolygon实体(RTENAME)

返回值:
返回交集区域的MPolygon实体,失败返回nil

示例用法:
(xdrx-mpolygon-intersect ent1 ent2)
; 计算两个MPolygon的交集区域

注意事项:
1. 结果实体继承第一个MPolygon的属性
2. 第二个MPolygon实体将被删除
3. 仅支持两个MPolygon实体输入
4. 无交集时返回nil
5. 返回实体可直接用于后续操作
------------------------------------------------------------
8
函数名称: xdrx-mpolygon-loopCrosses

描述:
检测多段线多边形(MPolygon)的自交或互交情况

调用格式:
(xdrx-mpolygon-loopCrosses <MPolygon实体> [<MPolygon实体2>])

参数说明:
* <MPolygon实体>: 目标MPolygon实体(RTENAME)
* [<MPolygon实体2>]: 可选参数(RTENAME),第二个MPolygon实体

返回值:
返回交点坐标和边索引列表,无交点返回nil

示例用法1:
(xdrx-mpolygon-loopCrosses ent)
; 检测单个MPolygon的自交情况

示例用法2:
(xdrx-mpolygon-loopCrosses ent1 ent2)
; 检测两个MPolygon的互交情况

注意事项:
1. 单参数模式检测自交
2. 双参数模式检测互交
3. 返回格式为((交点列表)(边索引列表))
4. 非MPolygon实体返回nil
5. 结果可用于几何分析
------------------------------------------------------------
9
函数名称: xdrx-mpolygon-make

描述:
从多种输入创建多段线多边形(MPolygon)

调用格式:
(xdrx-mpolygon-make [<输入实体或点列表>] [模式] )

参数说明:
* [<输入实体或点列表>]: 可选参数,可以是:
- 实体(RTENAME/RTPICKS): 多段线/圆/样条曲线等
- 点列表: 定义多边形顶点的点列表
* [模式]: 可选参数(RTSHORT),控制创建方式:
- 0: 直接创建
- 2: 删除同心区域
- 4: 生成闭合区域
* : 可选参数(RTT),删除输入实体

返回值:
返回创建的MPolygon实体,失败返回nil

示例用法1:
(xdrx-mpolygon-make (ssget))
; 从选择集创建MPolygon

示例用法2:
(xdrx-mpolygon-make '((0 0)(10 0)(10 10)(0 10)))
; 从点列表创建MPolygon

注意事项:
1. 支持多种输入类型转换
2. 自动处理非闭合曲线
3. 可保留或删除原实体
4. 支持复杂多边形创建
5. 返回实体可直接编辑
------------------------------------------------------------
10
函数名称: xdrx-mpolygon-remake

描述:
重新生成多段线多边形(MPolygon)的几何结构

调用格式:
(xdrx-mpolygon-remake <MPolygon实体>)

参数说明:
* <MPolygon实体>: 目标MPolygon实体(RTENAME)

返回值:
返回重构后的MPolygon实体,失败返回nil

示例用法:
(xdrx-mpolygon-remake ent)
; 重新生成指定MPolygon的几何结构

注意事项:
1. 保留原实体的所有属性
2. 自动处理无效几何结构
3. 仅支持单个MPolygon输入
4. 无环的MPolygon将返回nil
5. 返回实体可直接用于后续操作
------------------------------------------------------------
11
函数名称: xdrx-mpolygon-split

描述:
使用曲线分割多段线多边形(MPolygon)

调用格式:
(xdrx-mpolygon-split <MPolygon实体> <分割曲线实体>)

参数说明:
* <MPolygon实体>: 目标MPolygon实体(RTENAME)
* <分割曲线实体>: 用于分割的曲线实体(RTENAME)

返回值:
成功返回T,失败返回nil

示例用法:
(xdrx-mpolygon-split ent1 ent2)
; 使用ent2曲线分割ent1 MPolygon

注意事项:
1. 分割曲线必须与MPolygon相交
2. 保留原MPolygon属性
3. 仅支持单个MPolygon和曲线输入
4. 返回分割后的新实体
5. 结果实体可直接用于后续操作
------------------------------------------------------------
12
函数名称: xdrx-mpolygon-subtract

描述:
执行两个多段线多边形(MPolygon)的布尔差集运算

调用格式:
(xdrx-mpolygon-subtract <目标MPolygon> <被减MPolygon>)

参数说明:
* <目标MPolygon>: 主MPolygon实体(RTENAME)
* <被减MPolygon>: 要减去的MPolygon实体(RTENAME)

返回值:
成功返回T,失败返回nil

示例用法:
(xdrx-mpolygon-subtract ent1 ent2)
; 从ent1中减去ent2的区域

注意事项:
1. 保留主MPolygon的属性
2. 被减MPolygon将被删除
3. 仅支持两个MPolygon实体输入
4. 必须有重叠区域
5. 结果实体可直接用于后续操作
------------------------------------------------------------
13
函数名称: xdrx-mpolygon-union

描述:
执行两个多段线多边形(MPolygon)的布尔并集运算

调用格式:
(xdrx-mpolygon-union <MPolygon实体1> <MPolygon实体2>)

参数说明:
* <MPolygon实体1>: 第一个MPolygon实体(RTENAME)
* <MPolygon实体2>: 第二个MPolygon实体(RTENAME)

返回值:
成功返回合并后的实体,失败返回nil

示例用法:
(xdrx-mpolygon-union ent1 ent2)
; 合并ent1和ent2为一个MPolygon

注意事项:
1. 保留第一个MPolygon的属性
2. 第二个MPolygon将被删除
3. 仅支持两个MPolygon实体输入
4. 结果实体可直接用于后续操作
5. 若无重叠区域仍会合并为一个实体
------------------------------------------------------------


页: [1]
查看完整版本: XDrxAPI 13 个 MPolygon 函数帮助手册