Catia二次开发CAA中的交互操作开发原理和过程大全
CAA中的交互操作开发，主要包括原理说明，开发过程说明和案例探究。参考阅读：
百科全书->UserInterFace->WinTopCommand
01.CATIA命令
CATIA中命令主要有三种：单步命令，对话框命令，状态转换命令。
•（1）基本命令，也称（basicCommands）：运行时用户不能有附加选项，从其开始运行直至其结束期间无法停止，也称单步命令，该类命令派生自CATCommand类。•（2）对话框命令（DialogBoxCommands）：用户可以输入参数值或选择选项，对话框本身即命令，而不是其它命令的一部分，该类命令派生自CATDlgDialog类。•（3）状态对话命令（StateChartCommands）：状态对话命令被模拟为状态机，通过状态、迁移（或转换）的组合可构成高级对话命令。命令中可有数个状态，每个状态让用户选择对象、输入参数或选择选项。根据选择的对象、输入参数或选项判断是否满足条件，如果满足相应条件则触发迁移，跳转到下一状态执行，直到命令结束。对话框可用于状态对话命令作参数或选项输入界面。该类命令派生自CATStateCommand类。
本文重点说明第三种命令，即状态命令。
在CATIA操作中，交互操作情景很多，如点击屏幕画点、线，
如交互方式输入数值创建特征，
如用鼠标点选已有模型特征......
在这些交互操作中，前一步操作往往作为下一步操作的输入或者执行条件，因此需要程序识别每次操作的状态。而维持这一过程有序进行的正是状态机制（satemachine）.
02.状态机制
•状态机制(state-machine)是由状态和迁移组成的图，通常状态机附属于类，描述了类实例对接收事件的响应。•状态机是某个类的对象所有可能生命历史的模型，所有外部世界对对象的影响被总结为事件。从命令激活到最后取消，命令生命周期中所有事件都可以用状态机表示。
如上图中点击屏幕获取三点并绘制成折线的状态图可表示如下
•事件是具有时间和空间位置的显著发生的某件事，如鼠标在窗口某个位置点击、控件的某个操作，鼠标移动等。
•当状态机检测到事件，将对事件作出判断，并以相关于当前状态的方式来响应，这里的判断称为迁移条件。响应可能包括动作的执行和改变到新的状态。
因此，上图中状态机制运行如下：状态机制从开始状态进行到结束状态。从开始状态进入到状态1的转移中无任何函数响应调用，命令自动跳转到状态1的执行，即在鼠标点击事件执行后，在鼠标点击位置创建一个点，只要用户指定一个有效的点，当鼠标左键按下去的时候，鼠标按键事件就已经被检测出，并判断满足创建点的条件，执行响应函数绘制了一个点，同时状态就从第一个状态转移到第二个状态即状态2，第二个状态也是等待用户用鼠标指定一个点。当鼠标第二次按下去的时候，创建第二个点，同时状态就从状态2转移到状态3，鼠标按键事件已经被检测出，直至三个点创建完成，判断了绘制折线的条件，执行了响应函数绘制了一条折线，同时状态从第三个状态转移到最终状态，即结束操作。
03.状态命令创建
状态命令主要继承于CATStateCommand，该命令类主要用于接收CATIA中用户的交互输入。
一个状态命令的执行是基于三个工具而完成的，即代理（Agents)，状态(States)，转移(Transitions)。
Agents：获取用户操作的事件及选择的对象
States：对话框中等待用于输入
Transitions：定义哪些指令将被执行
状态命令执行条件：
1.为每个状态定义一个输入类型
2.一个状态转移需定义由源状态到目标状态的转变
3.基于条件的状态触发：包括最终事件驱动——用户的交互操作，条件确认用户输入。当某个状态被触发时，目标状态将被激活。
4.状态转移过程中，可以执行一个或多个指令（Action）
状态命令开发说明：
1.创建一个新类（Class）继承于CATStateCommand
2.至少覆盖：描述自己的状态（State）的变迁：BuildGraph()
适时管理命令的生命周期：Activate()、Desactivate()、Cancel()
3.定义一些方法，作为条件的验证及指令（Action）的执行
4.保存命令对话框中agent的数据成员
状态命令执行条件：
1.为每个状态定义一个输入类型
2.一个状态转移需定义由源状态到目标状态的转变
3.基于条件的状态触发：包括最终事件驱动——用户的交互操作，条件确认用户输入。当某个状态被触发时，目标状态将被激活。
4.状态转移过程中，可以执行一个或多个指令（Action）
状态命令开发说明：
1.创建一个新类（Class）继承于CATStateCommand
2.至少覆盖：描述自己的状态（State）的变迁：BuildGraph()
适时管理命令的生命周期：Activate()、Desactivate()、Cancel()
3.定义一些方法，作为条件的验证及指令（Action）的执行
4.保存命令对话框中agent的数据成员
本文将重点说明三个概念（代理，状态和转移）及其在CAA开发中的体现。（部分文字显示不全，建议横屏查看或者联系作者获取文档。）
1
对话框代理（Agents）
•对话代理（DialogAgent）是处理与界面命令相关的一个接口CATDialogAgent,其中与人机交互有关的代理大致分为2类，选择代理（PathElementAgent）和指定代理（IndicationAgent），他们分别对应接口CATPathElementAgent和CATIndicationAgent。
1.对话框代理（CATDialogAgent）：
CATDialogAgent是主要类，该类可以用来定义一个Agent与命令对话框中对象的连接
当一个事件发生时，这个Agent将被赋值.通常用于面板的交互和输入消息提示。
2.选择代理（PathElementAgent）：
如果文件中的对象显示在视图中，用户用左键选择它，这个对象可以作为后续工作的输入，如选择两个点绘制一条直线，选择三个点绘制一条折线等交互式选择。CATPathElementAgent代理主要处理这种与选择有关的操作。
说明：
•在catia中鼠标的每次选择对象都会产生路径，就是所选对象的位置路径，比如选中了某个点后会产生路径:Product.1\part.1\几何图形集\点.1。若选择的是实体表面可能会产生路径：part.1\零件几何体\凸台.1\面。这种路径未必会按照CATIA中的结构树的上下级关系产生。它是按照几何元素对象的拓扑关系产生的。
•在选择后会自动产生路径，并将路径存放在CATPathElementAgent的实例对象中。所以我们在选择了零件中的一个几何对象后从选择代理实例追溯它的路径中包含的对象。
•常用情形是在装配体中选择某个几何对象后获取几何对象所在的part名称，product名称，对象名称等。
选择代理的定义：
在.h文件中声明，
classCAADegCreatePlaneCmd:publicCATStateCommand
{
…
private:
CATPathElementAgent*_daPathElement;
…
}
在.cpp文件BuildGraph()中实例化，
voidCAADegCreatePlaneCmd::BuildGraph()
{
...
_daPathElement=newCATPathElementAgent("GetPoint");
_daPathElement->AddElementType(IID_CATIGSMPoint);
...
}
注意：
这里字符串“GetPoint”定义了一个选择代理在程序中的唯一识别符号。AddElementType方法的参数给定了选择代理只能识别CATIGSMPoint类型的点对象，其他对象一概不能识别。
AddElementType也可以通过字符串的方式给定，比如：
_daPathElement->AddElementType("CATIGSMPoint");
若可以选择的对象较多是可以采用字符串链表的形式给定，如下所示：
CATListOfCATStringTypes;
Types.Append("CATPoint");
Types.Append("CATINewHole");
Types.Append("CATISketch");
Types.Append("CATIGSMLineNormal");
Types.Append("CATIGSMLinePtPt");
_daPathElement->SetOrderedTypeList(Types);
3.指示代理（IndicationAgent）
•指定代理处理指鼠标在屏幕上点击（空白处点击）或者移动的时候发生的事件。
•点击或者移动的过程中产生临时2D点。指定代理能够获取文件中不存在的临时2D点的坐标，这2D点是由用户在2D(如草图或工程图中)或3D视图（如装配视图）中屏幕上点击左键或移动鼠标产生的。
•一个指定代理致力于怎么从2D屏幕所在的平面中获取2D点坐标，并将坐标转化在绝对坐标系。鼠标在屏幕上的点击是不确定的（只给定了2个坐标值），如果给定一个投影平面，那么在屏幕上的点击会根据视线方向（当前视角给定）投影到投影平面。（默认的投影平面就是与屏幕平行的平面，也可给指定代理提供一个平面）。
指示代理的定义：
在.h文件中声明，CATIndicationAgent *_daIndication;
在.cpp文件BuildGraph（）中实例化
_daIndication=newCATIndicationAgent("PointIndication");
代理的行为定义：
voidCATDialogAgent::SetBehavior(CATDlgEngBehavioriBehavior);
代理行为表现在代理接收通知消息后的反映，如定义一个平面类型的选择代理并设置代理行为为高亮提示，当鼠标移动到平面时即可看到该平面高亮。
_daIndicationP->SetBehavior(CATDlgEngAcceptOnPrevaluate| CATDlgEngWithPrevaluation);
通用对话框代理的组成包括：
行为模式：Thebehaviormode
通告集：Thenotifierset
通知组合：Thenotificationpattern.
如一个可重复/可撤销的代理行为设置如下
MyDialogAgent->SetBehavior(CATDlgEngRepeat|CATDlgEngWithUndo);
2
状态（States)
对话框代理用于用户交互式输入，它通常需要匹配一个或者多个状态(States),而且代理的赋值也通常需要对状态进行校验。如下图通过两点绘制直线的交互操作状态图中，整个操作过程包括四个状态：初始状态，选择起点状态，选择重点状态，最终状态。因此“状态”可以理解为交互命令执行的每个步骤。
图片来自百库全书
状态的创建：
注意：
The GetInitialState methodforthefirststate
CATDialogState*stStartState=GetInitialState("Start");
The AddDialogState methodforthesecondstate
CATDialogState*stEndState=AddDialogState("Second");
其中 Start 和 Second为状态提示信息。
不用创建初始状态和最终结束状态。
状态随着命令的删除而删除。
其次将代理添加到状态中：
stStartState->AddDialogAgent(_daIndicationAgent);
注意：
1.通常一个对话框代理只关联一个状态，但是可以在对话框的循环使用中管理几个状态，使用InitializeAcquisition 方法。
_daIndication->InitializeAcquisition();
2.另一方面，多个对话框代理可以关联一个状态。
SourceState->AddDialogAgent(_peAgent);SourceState->AddDialogAgent(_daAgent);
3
状态转移（Transitions）
状态转移连接着前后两个状态并触发相应指令（Actions）,当代理被赋值时状态转移会触发，比如当用户选择一个点时状态转移会被触发，并且若返回值是true，那么状态转移函数就会执行。
状态转移的定义：
状态转移代码也是在BuildGraph中编写。
CATDialogTransition*pFirstTransition
=AddTransition(SourceState,TargetState,...)
如利用两个点绘制一条直线的状态转移定义如下：
CATDialogTransition*pFirstTransition
=AddTransition(stStartState,stEndState,...);CATDialogTransition*pSecondTransition
=AddTransition(stEndState,NULL,...);
CATDialogTransition*pFirstTransition=AddTransition(stStartState,stEndState,
AndCondition(IsOutputSetCondition(_daIndication), Condition((ConditionMethod)&CAADegCreateLineCmd::CheckStartPoint)),...);CATDialogTransition*pSecondTransition=AddTransition(stEndState,NULL,
AndCondition(IsOutputSetCondition(_daIndication), Condition((ConditionMethod)&CAADegCreateLineCmd::CheckEndPoint)), ...);
状态转移的第一个参数为转移之前的状态，第二个参数为转移之后的状态，第三个参数为判断是否转移的条件，第四个参数为转移条件满足时执行的转移函数，这儿的转移函数为对输入点的检查。
4
小结
状态命令创建步骤：
声明和定义代理(CATPathElementAgent/CATIndicationAgent)
添加代理行为(SetBehavior)
创建状态(CATDialogState)
将代理添加到状态中(AddDialogAgent)
创建状态转移(Transitions)
创建指令函数（Actions）
释放选择代理指针，命令结束的时候应该在析构函数或者取消中添加释放选择指针的代码。如下所示：
CAADegCreatePlaneCmd::~CAADegCreatePlaneCmd()
{
...
if(_daPathElement)_daPathElement->RequestDelayedDestruction();
_daPathElement=NULL;
...
核心代码格式如下：
voidCAADegCreateLineCmd::BuildGraph()
{
//代理
_daIndication=newCATIndicationAgent("PointIndication");
_daIndication->SetMathPlane(_ProjPlane);
//状态
CATDialogState*stStartState=GetInitialState("stStartPointId");
CATDialogState*stEndState=AddDialogState("stEndPointId");
stStartState->AddDialogAgent(_daIndication);
stEndState->AddDialogAgent(_daIndication);
//状态转移
CATDialogTransition*pFirstTransition=AddTransition(stStartState,stEndState,
AndCondition(IsOutputSetCondition(_daIndication),
Condition((ConditionMethod)&CAADegCreateLineCmd::CheckStartPoint)),
Action((ActionMethod)&CAADegCreateLineCmd::CreatePoint));
CATDialogTransition*pSecondTransition=AddTransition(stEndState,NULL,
AndCondition(IsOutputSetCondition(_daIndication),
Condition((ConditionMethod)&CAADegCreateLineCmd::CheckEndPoint)),
Action((ActionMethod)&CAADegCreateLineCmd::CreateLine));
}
本文旨在说明状态命令的定义和编程过程，重点是基于状态机制，明确代理/状态/状态转移的定义。在了解基本概念的基础上，仍要结合百库全书中技术文章和案例熟悉其用法，欢迎大家在这块开发中提供相关意见和建议。
页:
[1]