Creating a Fix Constraint in an Assembly-为装配部件设置绝对位置

摘要

本文介绍 CAACreateCstInAssembly 用例，该用例演示如何在 CATProduct 文档中创建装配固定约束。

• 本用例将要学习的内容
• CAAAuiCreateCstInAssy 用例
  • CAAAuiCreateCstInAssy 实现功能
  • CAAAuiCreateCstInAssy 启动方法
  • CAAAuiCreateCstInAssy 代码位置
• 分步实现
• 小结
• 参考文献

通过本用例您将学到

本用例旨在帮助您初步掌握 CATIA 装配设计模块的编程方法。

其主要目的是在产品之间建立几何关联。具体而言，您将学习如何：

• 在会话中加载文档
• 创建连接对象
• 创建约束

在正式讲解本用例之前，有必要先理解装配设计核心的产品结构相关概念。

CAAAuiCreateCstInAssy 用例

CAAAuiCreateCstInAssy 是 CAAAssemblyUI.edu 框架下的一个用例，用于演示 CATAssemblyInterfaces 框架的各项功能。

在讲解该用例之前，需要先介绍几个核心概念：

• 固定约束是仅在单个零部件上创建的几何关系。
• 固定一个零部件，是指在更新操作过程中，阻止该零部件相对其父级零部件发生移动。
   
  注意：这是指根据装配体的几何原点固定其位置。
• 被施加约束的零部件必须是当前活动零部件的子级零部件。

CAAAuiCreateCstInAssy 的功能

 这是装配设计应用程序下一个典型的 CATIA V5 工作会话。当前正在编辑一个产品。

点击以下链接查看相关图片。点击图片可重置显示。

图中可以看到两个零部件，此处为两个机械零件：

• Jack_Frame
• Jack_Branch_3

这些零部件是根产品 Fix 的子级零部件，而 Fix 同时也是当前活动零部件。活动零部件 Fix 是已选中且正在编辑的零部件，在特征树中以蓝色边框显示。

可以在活动零部件 Fix 的各子级零部件之间施加约束。

约束在特征树中与子级零部件处于同一层级，并在几何区域中显示。

从编程角度来看，这些概念与最终用户在屏幕上所见及所操作的内容是对应的。因此我们将从用户视角入手，进而推导程序内部的操作逻辑。

如何运行 CAAAuiCreateCstInAssy

要运行 CAAAuiCreateCstInAssy，您需要先配置编译环境，然后编译 CAAAuiCreateCstInAssy 及其依赖模块，配置运行环境，最后执行该用例 [2]。

按如下方式启动用例：

在 Windows 系统下：

e:>CAAAuiCreateCstInAssy InputDirectory\Fix.CATProduct

在 UNIX 系统下：

$ CAAAuiCreateCstInAssyInputDirectory/Fix.CATProduct

其中：InputDirectory存放 Fix.CATProduct 文件的目录

CAAAuiCreateCstInAssy 代码位置

CAAAuiCreateCstInAssy 用例位于 CAAAssemblyUI.edu 框架下的 CAAAuiCreateCstInAssy.m 模块中：

• Windows 系统

InstallRootDirectory/CAAAssemblyUI.edu/CAAAuiCreateCstInAssy.m/

• Unix 系统

InstallRootDirectory/CAAAssemblyUI.edu/CAAAuiCreateCstInAssy.m/

其中 InstallRootDirectory 为 CAA 光盘资源的安装目录。


分步实现

CAAAuiCreateCstInAssy 主要包含三个核心步骤：

1. 在会话中加载产品文档
2. 创建连接对象
3. 创建约束

接下来我们将结合代码对每一部分进行详细讲解。

在会话中加载产品文档

将一个 CATProduct 文档加载到当前会话中。相关内容已在产品结构相关用例 [1] 中详细说明。

创建连接对象

::GetProductConnector(pGeometry,
                      pInstanceComponent,
                      pActiveComponent,
                      0,
                      pConnector,
                      iCreation);

全局函数 GetProductConnector 用于在零部件实例上创建一个连接对象。

pGeometry 　　　　　　　　　　要引用的几何元素，该几何元素必须可关联，以保证其在会话期间的稳定性。

pInstanceComponent　　　　　　包含上述几何元素的零部件实例。

pActiveComponent 　　　　　　　活动零部件，用于定义将在其中创建约束的参考零部件文档。

0 　　　　　　　　　　　　　　　查找模式：若未找到连接器则创建

pConnector 　　　　　　　　　　生成的特征

iCreation 　　　　　　　　　　　0：连接器已存在并被找到，

　　　　　　　　　　　　　　　1：连接器已被创建。

创建约束

rc = ::CreateConstraint(catCstTypeReference,
                        ConnectorList,
                        NULL,
                        pActiveComponent,
                        pCst);

CreateConstraint 全局函数用于在组件实例上或组件实例之间创建约束。

catCstTypeReference　　　　　需要创建的约束类型，此处为固定约束

ConnectorList　　　　　　　　包含约束所关联的连接器的列表

NULL　　　　　　　　　　　　约束参数值，仅用于角度约束或偏移约束

pActiveComponent　　　　　　当前活动组件

pCst　　　　　　　　　　　　创建完成后生成的约束特征

简而言之

本用例演示了如何约束装配体中的组件、创建连接器以及创建约束。