简介这份文档面向从事CATIA V5二次开发的工程师与学习者聚焦在Windows XP环境下使用VC 6.0与CAA组件应用架构进行界面二次开发这一相对冷门的方向。内容从CATIA二次开发的两种方式切入对比宏Macro自动化与CAA-RADE两条技术路线并给出新建独立workbench、添加工具条与按钮、插入CATIA风格对话框、建立command响应及通过参数直接生成三维模型的完整实例最后以五坐标数控机床运动仿真系统作为综合案例呈现当时的研究成果。资源包共1个doc文件约205KB为纯文档型技术资料适合按章节顺序阅读或作为CAA入门参考手册查阅。目前已有6419人学习对缺少CAA中文资料的开发者而言可从中获取界面定制流程、组件对象模型与OLE技术要点以及工作台搭建的实操思路。1. 从一次机床仿真需求说起这套 CATIA 二次开发资料到底能干什么几年前接过一个活客户要把五坐标数控机床的加工过程在 CATIA 里跑起来不是放动画是读 NC 文件、按真实刀位点驱动部件运动、还要能显示刀轨。当时翻遍手头资料能讲清 CAA 工作台怎么建、工具条怎么挂、对话框回调怎么接的文档少得可怜大部分只停在“宏录制”这一层。这份资料的价值就在这儿它把 CATIA V5 基于 CAA 的界面二次开发从建 workbench 到生成三维模型、再到机床运动仿真整条链路走了一遍还带了可对照的代码片段。适合两类人——正在用 CATIA 做专用工具、想把重复操作固化成按钮和菜单的工程师以及要交付机床/装配仿真模块的二次开发人员。读完你至少知道一个自定义命令从资源文件到 C 响应类是怎么串起来的以及为什么很多人卡在第一步就放弃了。2. 两条开发路线怎么选宏录制与 CAA-RADE 的边界2.1 进程内与进程外先搞清楚代码跑在谁的进程里CATIA 的二次开发接口按通信方式分两类这个划分决定了你后面所有技术选型。进程内方式下脚本和 CATIA 跑在同一个进程地址空间典型就是宏Macro。你在 CATIA 里点“录制宏”做一遍拉伸、倒角、改参数它生成一段 VBScript 序列回放就能重复操作。这种方式上手快在 CATIA 环境里就能完成不需要装编译器。但它有个硬伤宏运行期间 CATIA 处于非激活状态宏调用之间存不住变量值你想做个“先读用户输入、再根据输入算尺寸、最后建模”的交互流程纯宏会很别扭。进程外方式下外部程序和 CATIA 分属不同进程通过接口驾驭 CATIA创建修改环境和几何数据、读写尺寸还支持 OLE 对象连接与嵌入。这条路能做的事多得多代价是要处理进程间通信和对象生命周期。资料里给的判断很直接要快速自动化重复操作宏够了要做带界面、带交互、带复杂建模逻辑的专用系统必须上 CAA。提示别一上来就奔 CAA。先用宏把业务操作跑通确认几何操作序列没问题再考虑把它翻译成 C 命令能省掉大量调试几何逻辑的时间。2.2 宏路线的实际开发流程宏这条线的流程可以概括成“录制—清理—参数化—挂图标”。录制出来的 VBScript 往往带一堆硬编码的坐标和对象名直接回放换个零件就崩。常见做法是把关键数值抽成变量用InputBox拿用户输入用MsgBox做结果反馈对 NT 平台还可以用 Visual Basic 做更复杂的输入输出面板。跑通之后给宏关联一个图标塞进 CATIA 显示框架操作入口就有了。 录制后清理过的宏片段读取半径与拉伸长度生成圆柱 Dim radius, height radius CDbl(InputBox(输入截面圆半径(mm), 参数输入, 20)) height CDbl(InputBox(输入拉伸长度(mm), 参数输入, 50)) Dim partDoc, body, sketch, pad Set partDoc CATIA.ActiveDocument Set body partDoc.Part.Bodies.Item(1) 此处省略草图创建细节重点是参数来自用户输入而非硬编码这段代码的关键不在语法在于把录制产物里的常量替换成运行时输入。InputBox返回的是字符串必须CDbl转数值否则后续几何运算会类型报错。半径和高度单位要跟文档单位一致CATIA 内部按毫米算输入框里别混进厘米。2.3 CAA-RADE 的定位与代价CAAComponent Application Architecture是达索产品扩展和客户二次开发的工具集配套的 RADERapid Application Development Environment是可视化集成开发环境以 Microsoft Visual C 6.0 为载体开发工具完全集成进 VC 环境还带一个 CAA 框架程序编译器。注意后半句——它同时限制了 VC 的部分功能你熟悉的某些编译选项和调试手段在这里不一定好使。CAA 采用面向对象语言开发过程本质是组件对象的组合和扩展底层用 COM 和 OLE 技术。资料里对它的评价很实在这是高端 CAD/CAM 开发环境里最复杂、功能也最强的一个。复杂在哪CATIA 本身结构层次化、严谨CAA 又涉及深层次内容同样的界面功能别的 CAD 可能几十行搞定这里要建接口、建工厂、建描述类、配资源文件。但换来的是能深度集成做出跟原生模块并列的工作台。3. 工作台与界面搭建从空 workbench 到带图标的工具条3.1 新建独立 workbench 的六个步骤CATIA V5 把一类交互命令的工具条分组显示在不同工作台里自建 workbench 的意义就是把你二次开发的一堆命令集中到一个入口跟现有模块并列。资料给的步骤是六步创建工作台厂的接口、创建工作台厂、创建工作台描述类、创建响应命令的标题、创建工作台并排列图标按钮响应、提供图片及提示资源并把工作台插入开始菜单最后是创建工作台显示界面。这六步听着抽象落到代码上核心是一个派生类。按钮和工作台的描述类派生自CATBaseUnknown所有接口都从IUnknownCATBaseUnknown继承。这个类里通常放两个函数返回CATCmdWorkbench*的CreateWorkbench()负责顺序插入工具条、按钮、菜单CreateCommands()负责把插入的按钮和响应函数关联起来。新建的MyWorkBench插进开始菜单后跟 CATIA 现有模块是并列关系进去之后默认是空的工具得自己加。3.2 用 NewAccess 宏拼出工具条和按钮工作台、工作场在 CAA 里被看作入口的集合包NewAccess(className, variableName, objectName)宏创建一个入口SetAccessChild和SetAccessNext负责把入口连成树。className的取值有CATCmdContainer、CATCmdWorkshop、CATCmdSeparator、CATCmdStarter几种分别对应容器、工作场、分隔线、启动项。// 创建工具条容器并挂到工作台下 NewAccess(CATCmdContainer, pCAAAfrTB1EltTlb, CAAAfrTB1EltTlb); SetAccessChild(pCAAAfrGeoCreationWkb, pCAAAfrTB1EltTlb); // 创建按钮 cmd1绑定响应宏 CAAAfrCmd1Hdr加入工具条 NewAccess(CATCmdStarter, pCAAAfrTTB1EltCmd1Str, CAAAfrTTB1EltCmd1Str); SetAccessCommand(pCAAAfrTTB1EltCmd1Str, CAAAfrCmd1Hdr); SetAccessChild(pCAAAfrTB1EltTlb, pCAAAfrTTB1EltCmd1Str);逐句看第一段NewAccess建了个CATCmdContainer类型的容器变量名pCAAAfrTB1EltTlb这就是工具条本体SetAccessChild把它设成工作台的子节点工具条才会显示在工作台里。第二段建CATCmdStarter这是可点击的启动项SetAccessCommand把它的响应指向CAAAfrCmd1Hdr这个命令头SetAccessChild再把它挂进工具条容器。顺序不能乱先有容器再挂子项否则运行起来工具条是空的。3.3 资源文件图标、标题、提示都靠 CATRsc 和 CATNls代码建好了结构界面上显示什么由资源文件决定。图标在CAAAfrGeoCreationWkbHeader.CATRsc里关联CAAAfrGeoCreationWkbHeader.CAAAfrCmd1Hdr.Icon.Normal I_CAACmd1;这行的意思是命令头CAAAfrCmd1Hdr的普通状态图标用I_CAACmd1实际图片是CAACmd1.Bmp。标题和提示写在CAAAfrGeoCreationWkbHeader.CATNlsCAAAfrGeoCreationWkbHeader.CAAAfrCmd1Hdr.Category Element; CAAAfrGeoCreationWkbHeader.CAAAfrCmd1Hdr.Title command1; CAAAfrGeoCreationWkbHeader.CAAAfrCmd1Hdr.ShortHelp new cmd1;Category决定命令归到哪类Title是按钮悬停和菜单里显示的名字ShortHelp是状态栏短提示。这三个字段漏一个界面上就会出现空白按钮或者无提示的哑按钮排查时优先查 CATNls 的键名拼写——键名必须和代码里的命令头完全一致大小写敏感。3.4 菜单的添加与按钮的差异菜单添加跟按钮类似同样在CreateWorkbench()里但宏参数和连接方式不同。菜单需要CATCmdContainer做菜单容器中间插CATCmdSeparator做分隔线子菜单项用SetAccessNext串起来而不是SetAccessChild。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用在分隔线和子菜单之间表示“下一个兄弟节点”而SetAccessChild表示“子节点”。搞混这两个宏是新手最常见的错误表现是菜单项跑到错误层级或者干脆不显示。菜单标题同样在 CATNls 里配比如CAAAfrMeu1EltSnu.Title 新建菜单1。4. 命令响应与对话框把按钮点击接到建模代码上4.1 三种 command 类型怎么挑workbench 框架搭好后按钮得有响应。CAA 里可创建的响应类都派生自CATCommand通过 RADE 菜单 Insert 下的 CATIA Resource → Command 创建有三种类型Statechart command、dialog-box based command、Basic command。Basic command 生成空响应类逻辑写在Activate(CATCommand* iFromClient, CATNotification* iEvtDat)里适合不需要界面的纯操作。dialog-box based command 运行时会直接弹对话框二次开发里用得最多因为大部分专用工具都要用户输参数。Statechart 适合有状态流转的复杂交互入门阶段可以先放一放。4.2 对话框控件布局与 SetGridConstraints选 dialog-box based command 后RADE 会生成一个可编辑对话框右侧控件面板里有CATDlgFrame、CATDlgLabel、CATDlgEditor、CATDlgPushButton、CATDlgRadioButton等。所有控件在Build()函数里创建位置靠SetGridConstraints(short int iTopRow, short int iLeftColumn, short int iRowSpan, unsigned int iJustification)设置——本质是把对话框当网格指定控件占第几行、第几列、跨几行、对齐方式。// Build() 中创建标签和输入框并按网格定位 _pLabelRadius new CATDlgLabel(this, RadiusLabel); _pLabelRadius-SetTitle(截面圆半径); _pLabelRadius-SetGridConstraints(0, 0, 1, CATGRID_LEFT); _pEditorRadius new CATDlgEditor(this, RadiusEditor); _pEditorRadius-SetGridConstraints(0, 1, 1, CATGRID_LEFT);行号列号从 0 开始iRowSpan是纵向跨几行对齐常量用CATGRID_LEFT这类。布局翻车的典型表现是控件叠在一起或者跑出对话框边界原因多半是行列号冲突或跨行数写大了。改布局不用重编译整个工程调Build()里的约束参数重新构建即可。4.3 回调函数从按钮点击到生成拉伸体给CATDlgPushButton加回调RADE 提供 Creation、Visibility swap、Resizement、Button activation、Repetitive button activation 五种。最常用的是 Button activation生成OnPushButton004PushBActivateNotification(CATCommand* cmd, CATNotification* evt, CATCommandClientData data)点击逻辑写这里面。资料里的实例是输入截面圆半径、拉伸长度、拉伸方向与截面法向夹角生成拉伸体并可改位置。这条链路是回调里从CATDlgEditor读字符串、转数值、校验范围然后走 PartDesign 相关接口建草图、拉伸、按角度做旋转定位。参数校验别省用户输入非数字或者负半径不拦就会在几何内核里抛异常调试信息还很难读。void CAAAfrCmd1Dlg::OnPushButton004PushBActivateNotification( CATCommand* cmd, CATNotification* evt, CATCommandClientData data) { CATUnicodeString txt; _pEditorRadius-GetText(txt); double radius atof(txt.ConvertToChar()); if (radius 0.0) { // 非法输入直接返回避免几何内核异常 return; } // 后续调用 PartDesign 接口建草图并拉伸角度参数用于定位 }GetText拿到的是CATUnicodeString转char*再转数值是常见写法。半径校验放在最前面负值或零直接 return比让内核报错再回溯省事得多。角度参数在拉伸后用于CATMathTransformation构造旋转矩阵这一步和下一章的机床运动仿真共用同一套变换思路。5. 五坐标机床运动仿真从 NC 文件到部件移动5.1 模块划分与模型组织这个实例在自建 workbench 下分两个模块机床模型建立模块和运动仿真模块各自配 Toolbar、对话框和响应函数搭法就是前面几章那套。模型组织上用了 CATIA 的产品结构模块机床文件是*.CATProduct。各部件先用 PartDesign 建成独立*.CATPart再用 3D PLM PPR 组件做整机装配。资料明确说选代码生成模型而不是手工建模原因是后面要对模型加行程约束、按参数驱动代码生成的模型结构可控遍历时好定位。注意装配层级直接决定后面遍历找部件的难度。命名规范、层级扁平化要在建模阶段就定好等仿真代码写完再回头改产品结构接口里的路径全得重写。5.2 读 NC 文件、找根产品、驱动部件移动仿真主链路是读 NC 文件解析出移动方向和坐标值用CATIDocRoots接口拿到机床模型的根产品Root Product遍历产品树找到要移动的对应部件取CATIMovable接口执行移动移动矩阵是CATMathTransformation类型。// 取根产品并遍历找到目标部件后施加位移 CATIDocRoots* pDocRoots NULL; pDocRoots-GiveRootProducts(rootProducts); CATIMovable* pMovable NULL; // 对遍历到的目标部件 QueryInterface 取 CATIMovable if (SUCCEEDED(pComponent-QueryInterface(IID_CATIMovable, (void**)pMovable))) { CATMathTransformation trans; // 按 NC 解析出的方向与坐标构造平移矩阵 trans.SetTranslation(CATMathVector(dx, dy, dz)); pMovable-SetPosition(trans); }CATIDocRoots是入口拿不到根产品后面全白搭QueryInterface取CATIMovable失败说明该部件在产品结构里没被标记为可移动得回模型里检查。CATMathTransformation既能表达平移也能表达旋转五坐标机床的摆头、转台运动都靠它组合。NC 解析出来的坐标是刀位点映射到具体轴的运动量需要按机床运动学反解这部分资料没展开属于要自己补的活。5.3 刀轨生成与显示刀轨显示用了 CAA 的 GSM 和 Shape Design Styling能画直线、圆弧和样条曲线。实现思路是把 NC 文件里的刀位点按段类型分别建几何元素直线段两点一线圆弧段取圆心半径起止角样条段喂控制点。刀轨独立显示资料里图 11 那种效果通常是把轨迹放在单独的几何容器里控制显隐而不影响机床本体。这套东西不只用于虚拟加工仿真虚拟装配的动画显示也能复用——本质都是“读数据、算变换、驱动部件、画轨迹”。6. 避坑与二次开发改造几个我踩过的坑和一套验证习惯6.1 常见问题排查清单现象新建 workbench 在开始菜单里看不到。原因多半是资源文件没注册或 CATNls 键名与代码不一致。解决先确认工作台插入开始菜单那一步的资源声明齐全再逐字比对 CATNls 里的键名和NewAccess里的 objectName大小写和拼写都要一致。现象工具条显示但按钮是空白方块。原因是指标资源没关联上CATRsc 里Icon.Normal指向的图片名和实际 bmp 文件名对不上。解决检查I_CAACmd1对应的CAACmd1.Bmp是否在资源路径下文件名大小写敏感。现象点按钮没反应也不报错。原因是SetAccessCommand绑定的命令头和实际响应类名不一致或者CreateCommands()里漏了关联。解决在CreateCommands()里逐条核对SetAccessCommand的第二个参数必须和命令头定义完全一致。现象对话框控件重叠或超出边界。原因是SetGridConstraints行列号冲突。解决把每个控件的行列号列成表确保同一网格位置只放一个控件跨行跨列数别超过对话框总行列。现象仿真时部件不动或位置跳变。原因是QueryInterface取CATIMovable失败或变换矩阵构造时单位、顺序搞错。解决先确认部件在产品结构里可移动再检查CATMathTransformation的平移向量顺序和单位旋转组合顺序错了会导致姿态完全不对。6.2 二次开发改造思路与验证方法拿到这套代码要改成自己的专用工具我一般按“先跑通再替换”的顺序来。第一步不动业务逻辑只把工程编译通过、workbench 能显示、按钮能点、对话框能弹确认开发环境和资源链路没问题。第二步把示例里的拉伸体命令换成自己的几何操作保持命令框架和资源文件不动只改回调里的建模代码这样界面部分不用重调。第三步再动产品结构和仿真逻辑把 NC 解析换成自己的数据源把部件查找从硬编码路径改成按命名规则遍历。验证上有个笨办法但很管用每加一个命令先在 CATIA 里手动做一遍对应操作记下几何结果的关键参数体积、包围盒、关键点坐标再用代码跑一遍对比。数值对不上就说明接口调用顺序或参数有问题比盯着代码猜快得多。资源文件改动后一定要清一次构建再运行缓存导致的旧图标旧标题问题我遇到过不止一次。改造检查顺序按依赖从底到顶 1. 工程编译通过无链接错误 2. workbench 出现在开始菜单层级正确 3. 工具条、按钮、菜单显示完整图标标题正常 4. 对话框弹出控件布局正确输入可读取 5. 回调触发几何操作结果与手工操作一致 6. 产品结构遍历命中目标部件变换矩阵生效这套资料最值钱的地方不是某段代码而是把 CAA 界面开发那条又长又碎的链路完整走了一遍让你知道每一步该看哪个文件、哪个宏、哪个接口。从那以后我每次接 CATIA 二次开发的活都强制先按上面那个检查顺序走一遍哪怕只是改一个按钮图标也不跳步——跳过的每一步后面都会以更难查的形式还回来。希望帮到你。本文还有配套的精品资源点击获取