当前位置：首页 > web >正文

Pycaita二次开发基础代码解析：点距测量、对象层级关系与选择机制深度剖析

web 2025/7/29 13:46:28

一、空间距离计算实现解析

1.1 技术实现原理

距离计算功能的核心代码实现：

@classmethod
def min_distance_between_2_points(cls):# 获取混合体对象和其包含的混合形状ohybrid_body = opart.hybrid_bodies.item(1)ohybrid_shape = ohybrid_body.hybrid_shapes# 通过名称获取特定点对象ref1 = ohybrid_shape.item("Point.1")ref2 = ohybrid_shape.item("Point.2")# 获取SPA工作台进行空间分析spa = odoc.spa_workbench()msa = spa.get_measurable(ref1)# 计算并显示最小距离min_distance = msa.get_minimum_distance(ref2)min_distance = round(min_distance, 3)catia.message_box(f"min_distance = {min_distance}mm",64,"info")

1.2 关键技术点详解

1.2.1 混合体对象获取

ohybirid_body = opart.hybrid_bodies.item(1)

hybrid_bodies：表示零件文档中的混合体集合
item(1)：获取第一个混合体对象（索引从1开始）
opart：表示当前的活动零件（PartDocument活动实例）

关键说明：CATIA中的索引系统从1开始而非0，这是VBA接口的重要特性

1.2.2 混合形状访问

ohybirid_shape = ohybrid_body.hybrid_shapes

hybrid_shapes：混合体的几何特征集合
包含点、线、面等所有参考几何特征

1.2.3 精确对象获取

ref1 = ohybrid_shape.item("Point.1")

item()方法支持名称索引
参数需严格匹配几何对象的命名
常见错误：大小写敏感或多余空格导致获取失败

1.2.4 SPA工作台分析功能

spa = odoc.spa_workbench()
msa = spa.get_measurable(ref1)

SPA工作台：Space Analysis的缩写，提供测量分析接口
get_measurable()：创建可测量对象实例
odoc：当前活动文档对象

1.2.5 距离计算方法

min_distance = msa.get_minimum_distance(ref2)

get_minimum_distance()：核心空间分析方法
支持点、线、面、体之间的空间距离计算
返回结果为双精度浮点数

1.3 结果处理与显示

min_distance = round(min_distance, 3)
catia.message_box(f"min_distance = {min_distance}mm",64,"info")

round()：结果四舍五入，保留3位小数
message_box()：CATIA信息提示框
参数说明：
- 显示内容：距离值+单位
- 类型标识：64（信息图标）
- 标题："info"

二、对象选择操作精解

2.1 父级名称获取实现

@classmethod
def selected_parent_name(cls):osel.clear()filter_type = ("AnyObject",)catia.message_box("请选择对象！", 64, "信息")status = osel.select_element2(filter_type, "请选择对象！", False)if status != "Normal":catia.message_box("选择失败", 64, "信息")exit()ogs = osel.item(1).value.parentcatia.message_box(f"ogs_name = {ogs.name}",64,"info")

2.1.1 技术要点详解

选择器初始化
```
osel.clear()
```
- 清空当前选择集，确保选择操作清洁开始
过滤器设置
```
filter_type = ("AnyObject",)
```
- 元组定义选择过滤器
- "AnyObject"表示可选择任何对象
- 其他选项："Face"、"Edge"、"Vertex"等
选择操作
```
status = osel.select_element2(filter_type, "请选择对象！", False)
```
- select_element2()：高级选择方法
- 参数说明：
  - filter_type：对象类型筛选
  - 提示信息："请选择对象！"
  - False：禁用多选模式
- 返回值：操作状态字符串
异常处理
```
if status != "Normal":catia.message_box("选择失败", 64, "信息")exit()
```
- 检查操作是否成功
- 非"Normal"状态表示用户取消或错误
- exit()终止程序执行
父级获取
```
ogs = osel.item(1).value.parent
```
- item(1)：获取选择集中首个元素
- value：提取选中对象本身
- parent：访问对象的父级容器

2.2 对象自身名称获取

@classmethod
def selected_name(cls):osel.clear()filter_type = ("AnyObject",)catia.message_box("请选择对象！", 64, "信息")status = osel.select_element2(filter_type, "请选择对象！", False)if status != "Normal":catia.message_box("选择失败", 64, "信息")exit()ogs = osel.item(1).valuecatia.message_box(f"Name of selection = {ogs.name}",64,"info")

2.2.1 技术差异点

直接对象访问
```
ogs = osel.item(1).value
```
- 未使用.parent属性
- 直接获取选中对象本身
名称结构差异
```
f"Name of selection = {ogs.name}"
```
- 显示对象自身名称而非父级名称
- 适合零件级别的特征操作

三、CATIA API对象模型解析

3.1 核心对象关系图

3.2 关键对象说明

对象	类型	作用
`opart`	Part	当前活动零件
`ohybirid_bodies`	HybridBodies	混合体集合
`ohybirid_shape`	HybridShapes	几何特征集合
`osel`	Selection	全局选择器实例
`odoc`	Document	活动文档对象
`spa`	SPAWorkbench	空间分析工作台