CATIA CAA二次开发：工作台命令树与资源响应机制

简介CATIA二次开发主题文档面向从事高端CAD/CAM二次开发、希望基于CAA组件应用架构扩展CATIA界面的工程师与研究人员。内容围绕Windows XP环境下VC 6.0与CAA-RADE展开梳理CATIA V5的宏方式与进程内/进程外二次开发接口差异并以新建workbench、添加菜单工具条与按钮图标、插入CATIA风格对话框、建立command响应及用代码生成三维模型为例说明界面定制流程同时结合五坐标数控机床运动仿真系统呈现二次开发在工程仿真中的应用思路。文档以概念梳理与实例讲解为主重点展示从接口调用到界面响应的实现链条适合具备C与CATIA基础、想了解CAA开发入口的技术人员查阅。压缩包仅含1个doc文件约205KB。已有6423人学习下载便于读者快速建立CATIA二次开发的整体框架、理解工作台与命令组织方式并获取数控机床仿真案例的切入点。1. 一个新工作台为什么会凭空出现在 CATIA 的开始菜单里CATIA 的界面二次开发难的往往不是写 C难点在于要让框架先在那棵已经跑起来的命令树上给代码留出一个入口。基于 CAAComponent Application Architecture组件应用架构的二次开发是反直觉的代码全对、编译零警告运行时一个新工作台就悄无声息地出现在开始菜单里和原有二十多个模块并列而代码里只错一个字符串编译照样通过运行时却什么都没有也没有任何报错。这种“看不见”的特性让它比多数 CAD 平台的插件机制更让人费解。搞懂它的价值在于一旦看清 workbench 不过是一棵树上的节点按钮不过是一个资源键加一条命令头名字界面开发就从“玄学”退化成“对表”后面做五坐标数控机床运动仿真这类重活时才不会在环境问题上反复翻车。2. 进程边界宏和 CAA 之间隔着的是一条地址空间要理解 CATIA 的两种二次开发路线先别急着看语言——VBScript 和 C 的差别只是表象。真正的分水岭是代码跑在哪块内存里、能不能拿到几何对象的接口指针。这条边界一经划出后面所有“这个功能能不能做”的问题答案基本就定了。2.1 进程内、进程外、被宿主加载三种处境按最初的划分CATIA 的二次开发接口通过两种方式与外部程序通信进程内应用程序In-process Application和进程外应用程序Out-Process Application。进程内方式下脚本和 CATIA 运行在同一块进程地址空间里宏Macro是最典型的例子——录制宏后生成的是一段 VBScript 序列运行时宏关联一个图标放进 CATIA 显示框架里。这条路的限制很硬宏一开始运行CATIA 就处于非激活状态而且宏调用之间无法保存变量的值。原因不神秘——脚本引擎占用了宿主的主线程界面的消息泵交不出去而脚本的执行上下文随一次执行结束就销毁没有一个常驻对象替脚本保管状态。所以宏天生适合“一次跑完就完事”的批处理不适合需要来回交互、记住上一步选择的场景。进程外方式下外部程序和 CATIA 分别在不同地址空间里跑。CATIA 保持运行外部进程通过接口调用它创建、修改环境和几何数据并且支持对象连接与嵌入OLE。但跨进程有一道绕不开的成本参数要能编组marshalling几何对象的裸指针根本过不去所以自动化层暴露出来的只能是按名字寻址的东西——文档、选择集、集合里的第几项。CAA 则是第三种处境它编译出来的模块由 CATIA 自己加载等于站在进程内同时又享受 C 的强类型接口。这就是它能力最强的根本原因——它能拿到接口指针直接在这棵对象图上走。路线代码形态运行位置能拿到什么适合做什么宏VBScript可录制生成CATIA 进程内自动化对象模型按名字寻址一次性批处理、重复操作外部进程VB / C exe独立地址空间经编组后的自动化接口批量驱动、外部系统集成CAAC 动态库由 CATIA 加载CATIA 进程内完整接口指针与对象图自定义工作台、深度功能2.2 宏录下来的是动作序列不是设计意图宏之所以上手快是因为它把“用户点了什么”忠实记录下来。代价也在这里录下来的是动作不是意图。一段典型的录制结果大致长这样 宏记录器产出的骨架一切操作都从选择集出发 Dim oDoc, oSel, oPart Set oDoc CATIA.ActiveDocument 只能按名字拿到当前文档 Set oSel oDoc.Selection 选择集是唯一稳定的操作入口 oSel.Clear oSel.Add oPart.Bodies.Item(1) 引用靠序号和名字模型一改就失效 之后是一长串属性赋值坐标是录制那一刻的绝对值这段代码里没有一处表达“我要在这条边上倒个角”。它表达的是“选中第 1 个实体把某个属性设成 12.5”。模型结构一变、实体改名脚本立刻失效——这类血泪经验几乎每个用过录制宏的人都有一份。所以在宏里能做的自动化边界就是“同一份模型、同一套操作顺序”。另外自动化接口本身具备跟任何 OLE 兼容平台通讯的能力可以调用 InputBox 和 MsgBox 拿用户输入、做输出需要更复杂的输入面板时可以换成完整的 VB 来搭。这条路线是活的只是天花板低。2.3 CAA 把不确定性从运行期搬到了编译期CAA 走的是完全相反的方向不确定性尽量往编译期推。开发过程可以看作组件对象的组合与扩展——CAA 采用组件对象模型COM和 OLE 技术所有自定义类都从 CATBaseUnknown 派生接口从 IUnknown / CATBaseUnknown 继承下来编译器在你按下构建的那一刻就知道某个接口存不存在、签名对不对。支撑这套东西的是快速应用研发环境 RADE。它以 VC 6.0 为载体开发工具完全集成在 VC 环境里附带一个 CAA 框架程序编译器但同时限制了 VC 的部分功能。这个“限制”不是缺陷而是设计取舍RADE 要在 IDE 的工程系统里注入自己的工程模型、资源编译步骤和运行时视图与 IDE 耦合得越深就越不可能放开所有原生能力。代价是工具链被锁死——换编译器版本、换运行库都可能让整个工程链断掉。对一个要长期维护的专用系统来说这笔交易通常是划算的编译期锁定换来了运行期的确定性以及一条能直达几何内核的通道。3. 命令树NewAccess 到底在内存里建出了什么CATIA V5 把某一类交互命令按工具条分组摆在不同工作台workbench里。这个设计初衷是让用户好找工具对开发者来说它的副作用是你要加的东西本质上不是“一个按钮”而是这棵树上的一个节点。理解这一点后面所有宏参数才有意义。3.1 四种节点类型决定了界面长什么样工作场workshop和工作台workbench在框架眼里都是“入口的集合包”。挂进这个集合包的节点只有有限的几种类型NewAccess 宏的 className 参数就是在这里做选择CATCmdContainer容器工作台、工具条、菜单都靠它能挂孩子CATCmdWorkshop工作场级别的容器CATCmdSeparator分隔线菜单和工具条里的那条横杠CATCmdStarter叶子节点真正能点的那一下它自己不执行逻辑只绑定一个命令头名字四种类型覆盖了几乎所有界面需求。想加下拉菜单那就再套一层 CATCmdContainer。想加分隔线插一个 CATCmdSeparator。这套抽象非常省但也意味着你不能凭空造一种“新控件”——能做的只是这四种节点按不同方式组合。3.2 一个宏干三件事建对象、留指针、登记资源键NewAccess(className, variableName, objectName) 看起来只是创建对象实际上它一次做了三件事按 className 实例化一个命令节点把它赋给名叫 variableName 的成员变量供后续 SetAccessChild 之类的宏使用同时用 objectName 这个字符串在框架里登记一个资源键。第三件事最容易被忽略也最容易翻车。这个字符串是后面查图标、查标题、查提示语的钥匙。它和资源文件里的名字必须逐字符一致——大小写不同都不行因为资源查找是精确匹配。这也是为什么很多人的工作台“编译通过、菜单里却没有”树建起来了资源键对不上节点被创建但显示不出来。3.3 长子兄弟链为什么插一个工具条只改两个指针先看建工具条和按钮这段// 创建一个工具条容器名字同时作为资源键 NewAccess(CATCmdContainer, pCAAAfrTB1EltTlb, CAAAfrTB1EltTlb); // 把它挂成工作台的第一个孩子 SetAccessChild(pCAAAfrGeoCreationWkb, pCAAAfrTB1EltTlb); // 创建一个可点击的叶子节点并绑定命令头 NewAccess(CATCmdStarter, pCAAAfrTTB1EltCmd1Str, CAAAfrTTB1EltCmd1Str); SetAccessCommand(pCAAAfrTTB1EltCmd1Str, CAAAfrCmd1Hdr); // 按钮挂到工具条下 SetAccessChild(pCAAAfrTB1EltTlb, pCAAAfrTTB1EltCmd1Str);注意这里只有两种连接动作SetAccessChild 和 SetAccessNext。前者设“第一个孩子”后者设“下一个兄弟”。整棵树用“长子 兄弟”两条边表示没有父指针数组也没有孩子列表。常见的实现思路就是这样节点结构里只留两个指针插入一个同级的节点改的是前一个兄弟的 next 和它自己的 nextO(1)不涉及任何数组搬移。于是顺序变成了纯粹由代码书写顺序决定的东西你先 SetAccessChild 谁谁就是第一个后面每调一次 SetAccessNext就往兄弟链尾部接一个。菜单那段代码把这点暴露得很清楚// 菜单根容器 NewAccess(CATCmdContainer, pCAAAfrGeoCreationMbr, CAAAfrGeoCreationMbr); NewAccess(CATCmdContainer, pCATAfrInsertMnu, CATAfrInsertMnu); SetAccessChild(pCAAAfrGeoCreationMbr, pCATAfrInsertMnu); // 插入分隔线再在其后接子菜单 NewAccess(CATCmdSeparator, pCAAAfrGeoCreationInsertSep, CAAAfrGeoCreationInsertSep); SetAccessChild(pCATAfrInsertMnu, pCAAAfrGeoCreationInsertSep); NewAccess(CATCmdContainer, pCAAAfrMeu1EltSnu, CAAAfrMeu1EltSnu); SetAccessNext(pCAAAfrGeoCreationInsertSep, pCAAAfrMeu1EltSnu); // 子菜单下面再挂一个叶子仍然绑同一个命令头 NewAccess(CATCmdStarter, pCAAAfrMMeu1SubMn1Str, CAAAfrMMeu1SubMn1Str); SetAccessChild(pCAAAfrMeu1EltSnu, pCAAAfrMMeu1SubMn1Str); SetAccessCommand(pCAAAfrMMeu1SubMn1Str, CAAAfrCmd1Hdr);分隔线本身没有行为它存在的唯一意义就是占住兄弟链上的一个位置给后面的 SetAccessNext 一个锚点。这样做的好处是代码里没有任何“索引”概念你不需要知道分隔线是第几个。3.4 SetAccessCommand 为什么绑的是字符串而不是函数指针这段代码里最值得琢磨的一行是 SetAccessCommand(pCAAAfrTTB1EltCmd1Str, CAAAfrCmd1Hdr)。第二个参数是字符串不是函数指针。为什么因为这一行发生在 CreateWorkbench() 里而命令的响应类是在 CreateCommands() 里建的两者编译期根本不相见。框架在运行时按这个字符串去找对应的命令头header再由命令头实例化 CATCommand 派生类。用字符串做间接层换来的是两件事资源文件里的描述和代码里的绑定能对齐CATNls 里写的也是这个命令头名字以及同一个命令头可以被多处复用——上面例子里的 “CAAAfrCmd1Hdr” 同时挂在工具条按钮和菜单项上一份逻辑两个入口。代价同样是运行期才暴露名字拼错编译没问题点下去没反应。两个函数的分工也因此清晰起来CreateWorkbench() 负责“顺序插入工具条、按钮图标以及菜单”CreateCommands() 负责“把插入的按钮、菜单和响应函数关联起来”。前者管形状后者管行为。至于工作台怎么出现在开始菜单里链路是固定的几步创建工作台的工厂接口、创建工作台工厂、创建工作台描述类、创建响应命令的标题、建工作台并排列图标按钮、提供图片和提示资源、把新工作台插入开始菜单、最后给出显示界面。这一段枯燥但绕不过去——少任何一环工作台要么不出现要么出现但点不进去。4. 资源与响应图标为什么不在 C 里一次点击为什么要穿过五层通知把界面拆成“命令树 资源 响应类”三块是 CATIA 这套架构最像正经软件工程的地方也是最不像“写个 CAD 插件”的地方。三块各管一摊谁也别想越界。4.1 CATRsc 与 CATNls把会变的东西赶出编译单元代码里只写资源键实际内容放在两类文件里。CATRsc 管图标位图CATNls 管文本// 代码侧只声明用哪个资源键不描述资源长什么样 CAAAfrGeoCreationWkbHeader.CAAAfrCmd1Hdr.Icon.Normal I_CAACmd1; CAAAfrGeoCreationWkbHeader.CAAAfrCmd1Hdr.Category Element; CAAAfrGeoCreationWkbHeader.CAAAfrCmd1Hdr.Title command1; CAAAfrGeoCreationWkbHeader.CAAAfrCmd1Hdr.ShortHelp new cmd1;四行分别对应正常态图标、命令类别、按钮标题、悬停时的简短提示。写成“键 值”的形式值是可替换的文本图标名则指向 CATRsc 里注册的位图资源。这么拆的直接收益是本地化同一份二进制换一份 CATNls 就换一种语言不需要重新编译。间接收益是资源可以被独立打包和校验——图标缺了、文本键写错了是在资源层暴露而不是等到运行时按钮一片空白还找不到原因。很多“按钮显示空白”的现场问题都出在 CATRsc 和 CATNls 里登记的键与 NewAccess 第三个参数不一致。4.2 三种命令基类Basic、Dialog-box、Statechart响应类全部从 CATCommand 派生但创建时有三种可选形态选错了后面会很难受Basic command空的响应类逻辑写在 Activate(CATCommand * iFromClient, CATNotification * iEvtDat) 里。适合“点一下立刻做完”的动作比如切换某个显示状态。Dialog-box based command运行时直接弹出一个对话框对话框可以进一步编辑。适合需要用户填参数的场景是二次开发里用得最多的一种。Statechart command带状态迁移的命令适合“先选面、再选线、再给个方向”这种多步交互。这三种形态的差别不在功能强弱而在交互状态放在哪。Basic 命令没有状态每次点击都是一次独立调用对话框命令的状态存在对话框控件里状态机命令的状态由框架托管你只描述迁移。选型时先问一句“这个操作要不要记住上一步”答案基本就出来了。4.3 网格布局与五条通知路径对话框里的控件——CATDlgFrame、CATDlgLabel、CATDlgEditor、CATDlgPushButton、CATDlgRadioButton 之类——全部在 Build() 函数里创建。摆位置不用绝对坐标用 SetGridConstraints(short int iTopRow, short int iLeftColumn, short int iRowSpan, unsigned int iJustification)第几行、第几列、占几行、怎么对齐。不给你绝对坐标是好事。按钮标题换成另一种语言会长出一截字体和 DPI 也会变绝对坐标一改就全乱网格布局把这部分交给框架算你只声明相对关系。代价是行列出错时控件会叠在一起而这个错误在编译期看不出来。控件的每一种可能行为都是一条独立通知。以 CATDlgPushButton 为例可挂的回调有五类Creation创建时、Visibility swap显示/隐藏切换、Resizement尺寸变化、Button activation点击、Repetitive button activation按住重复触发。勾选 Button activation 会生成这样一个函数// 点击回调三个参数分别是发送者、通知对象、客户端数据 void CAAAfrDlg::OnPushButton004PushBActivateNotification( CATCommand* cmd, CATNotification* evt, CATCommandClientData data) { // cmd 是发出通知的命令对象evt 携带通知细节data 是注册时透传的上下文 // 这里读取编辑框里的半径、长度、角度再驱动几何生成 float radius 0.0f, length 0.0f, angle 0.0f; GetEditorValue(RadiusEditor, radius); // 从控件取值键名与 Build 中一致 GetEditorValue(LengthEditor, length); GetEditorValue(AngleEditor, angle); BuildPadFromParams(radius, length, angle); // 见 4.4 }三个参数里evt 最容易被当成摆设其实它决定了同一个回调能不能复用——通知对象里带着触发时的上下文多控件共用一个回调时靠它区分来源。把五条通知分开而不是合成一个 onEvent本质上是让编译器帮你检查“这个控件到底支不支持这种交互”少写一堆 switch。4.4 回调里做几何参数化拉伸体的三个入参回调打通之后往里面填什么就是业务问题了。一个能说明问题的例子是参数化拉伸体输入截面圆的半径、拉伸长度以及拉伸方向与截面法向之间的夹角生成一个可改变位置的实体。三个参数的选择不是随意的。半径决定截面长度决定体量夹角决定方向——前两个是标量第三个是方向信息合起来刚好覆盖“位置 姿态”的最小集合。控件取到值之后走的是 CATIA 自己的建模接口而不是自己算三角面片这样生成的几何才能参与后续的约束、装配和仿真。这也解释了为什么这条路线上必须用 CAA自动化层拿不到这些接口。5. 避坑排查编译能过、运行时什么都没有的五种现场这套机制最坑的地方在于绝大多数错误不在编译期暴露。下面五条是按出现频率排的每条都按“现象 → 原因 → 解决”记。5.1 编译与资源期一、工作台编译通过开始菜单里却没有现象构建成功启动 CATIA 后开始菜单里找不到新建的工作台也没有任何报错。原因工作台注册链路少了一环——工厂接口、工厂、描述类、命令标题、插入开始菜单这几步里断了一步或者 CATRsc / CATNls 里的资源键与 NewAccess 的第三个参数不一致。解决先把 NewAccess 的 objectName 与资源文件里的键逐字符比对包括大小写和前缀再确认描述类确实被框架实例化。二、按钮出现了但图标空白、提示为空现象工具条上有按钮位置对点得动就是没图没字。原因CATRsc 里的 Icon.Normal 指向的位图没注册进运行时视图或 CATNls 里 Title / ShortHelp 的键前缀写错。解决核对 “工作台头.命令头.属性” 这个三段式前缀前缀错一个字符整条资源都查不到改完资源后刷新运行时视图再启动。三、换一台机器就编不过现象同一份代码在原开发机上正常换机器后一堆链接错误。原因RADE 与 VC 6.0 深度耦合并且限制了 VC 的部分功能工具链、运行库、环境变量任何一处不一致都会让框架编译器失效。解决把工具链当成项目的一部分固定下来别指望用新版本编译器“顺便升个级”。5.2 运行期四、宏回放时界面卡住、变量丢失现象录制的宏单独跑没问题串起来跑就丢状态或者中途界面完全不响应。原因宏运行期间 CATIA 处于非激活状态且宏调用之间不能保存变量值。解决把一次宏执行内的所有步骤写成自包含的序列不要依赖上一次执行留下的变量需要跨步骤状态时改用外部进程驱动。五、机床部件读到了却不动现象遍历产品树能拿到部件赋了位置也没反应。原因拿到的不是可移动接口或者变换矩阵的构造顺序和预期不符——CATMathTransformation 类型的矩阵是左乘还是右乘决定了最终姿态。解决先确认 CATIMovable 接口确实查询成功再把矩阵拆成旋转和平移分别验证别一次性拼完整变换。6. 从界面到运动CATIMovable 凭什么能驱动整台机床五坐标数控机床运动仿真这条链路是把前面所有东西串起来的检验。做法是新建一个独立工作台下面分机床模型建立和运动仿真两个模块各自配工具条、对话框和响应函数。模型部分不用 CATIA 的手工建模而是用 CAA 的 PartDesign 接口逐个生成 *.CATPart再用 3D PLM PPR 组件装配成 *.CATProduct——这么做的好处是每个零件都带着代码可控的参数机床行程这类约束能直接挂上去。6.1 一条从 NC 文件到刀轨的调用链运行时序是这样的先读 NC 文件解析出移动方向和坐标值再用 CATIDocRoots 接口找到机床模型的根产品Root Product沿着产品结构遍历到要动的那个部件对它查询 CATIMovable 接口把方向与坐标组装成 CATMathTransformation 类型的变换矩阵交给接口完成移动。最后是刀轨显示用 GSM 和 Shape Design Styling 画出直线、圆弧和样条曲线刀轨可以独立显示。整条链里最关键的一步是查询 CATIMovable 而不是直接改位置属性。因为移动这件事在 CATIA 的对象模型里是一个能力capability不是数据字段——部件得先声明自己可动框架才会在更新机制里给它留位置。这也解释了避坑第五条接口查不到后面全白搭。6.2 为什么这套架构值得忍受它的复杂度CAA 是这个领域里最复杂、同时也最强的开发环境之一。它复杂是因为对象模型层次化、组件化每一层都要守规矩它强也是因为同一套规矩让代码能碰到几何内核、装配结构和运动能力。相比之下宏和外部进程那两条路能力边界在开口之前就已经画好了。我自己的习惯是凡是新起一个工作台先把资源键、命令头名字、工厂和描述类这四样东西列成一张对照表一项一项勾完再写业务代码。早年吃过一次亏——工作台“消失”了两天最后发现是资源键里少了个前缀编译一路绿灯。从那以后我每次动界面都强制走一遍这张表再没在环境问题上浪费过时间。这份资料里关于 CAA 界面开发到运动仿真的完整链路值得对着源码一段段啃下来。希望帮到你。本文还有配套的精品资源点击获取