|
1 前言 Pro/TOOLKIT是Pro/ENGINEER的一个应用程序接口(API),其的编程语言是C 语言,它可以对Pro/ENGINEER进行功能扩展,满足PTC客户的特定需求。而且,Pro/TOOLKIT提供了定制标准Pro/ENGINEER用户界面的能力,自动执行重复性的程序,通过Pro/ENGINEER集成的内部程序(Dll)或外部应用程序(Exe)可以为造型用户提供自定义的应用程序、设计规划和绘图自动化。
2 p# H( H: ]) c' C2 Pro/TOOLKIT编程条件和工具
( I: z9 d+ m6 S$ E 知道如何写C程序,就已经具备了使用Pro/TOOLKIT的条件,应该能够理解指针,当把数据从一个函数传到另一函数时,将经常使用到它。Pro/TOOLKIT帮助,包含2000多个函数,并且可以通过例子代码学习如何使用。除此之外,如果想解决几何学问题,还需要对失量理论有一定的了解。1 T/ g+ m* u' p5 ]0 t- b
3 Pro/TOOLKIT程序中的结构体
/ l' Z: V) g, D4 W/ H Pro/TOOLKIT都是用C语言编写的,每个对象都用结构体来描述,因此需要了解对象是如何使用的。为了使用结构体,需要定义它,Pro/TOOLKIT提供许多“typedefs”,这些typedefs只不过是Pro/ENGINEER结构体的伪指令。例如:5 x- T# Z& K% W; A
typedef struct entity* ProPoint;- P, R/ O \, Y0 C* i( E
typedef struct sld_part* ProSolid;0 `6 d1 [2 w* G% B% N2 w0 _
这些也叫做OHandles (from Opaque handles),在Pro/ENGINEER中它们直接获得对象的内存地址。在某些情况下,这样做可能是危险的,因此PTC提供了另外一种结构体类型,它只包含Pro/ENGINEER的内部数据库中项目的必要信息。这种结构体(labeled DHandle from data handle)是一种类的结构,它包括对象的类型、ID等。许多函数命令都和下面的结构体相联系。/ w' {3 M( O1 d- o: v; a
typedef struct pro_model_item
1 I; R" z3 j3 N( y! c{
$ {* s4 I+ p8 Z. K8 ~ProType type;
6 t# c/ ]" I5 oint id;
, b4 z K) `9 @0 P* B n" Z1 fProMdl owner;
' n0 Y: I( W N# V% F}ProModelitem,ProGeomitem,ProExtobj, ProFeature,ProProcstep,ProSimprep,ProExpldstate,
. Q; {6 }$ j. H0 aProLayer,ProDimension,ProDtlnote,ProDtlsyminst,ProGtol,ProCompdisp 3 {6 _) \8 }! u2 ]' H! ~0 @
) s4 k$ j' j, u X4 A) g! b
如果处理几何问题,要用到ProModelitem、ProGeomitem 和ProFeature这几个结构体。" K% a3 J# J3 O0 C% c# t0 v
4 Pro/TOOLKIT中的常用函数及使用
c; B+ e6 o q2 D 需要了解的第一个函数是ProMdlCurrentGet()。在Pro/TOOLKIT帮助中其描述如下。
9 w4 j1 h( l2 X! j% CDescription4 K. J2 h; w! Y& R! b' a( o) F
Initializes the p_handle with the current Pro/ENGINEER object. 9 d9 @1 W4 E6 P% e2 O
Synopsis: ~7 A5 j$ }7 h4 W
#include <ProMdl.h>/ k, {) b8 P6 d8 \* b4 ^. S2 @* A
ProError ProMdlCurrentGet (/ Z4 e. r: M8 X2 P! {/ n8 a
ProMdl *p_handle
a! S9 Y2 k- _' b/ ]/* (Out) : D {8 o# t* y
The model handle; N7 I/ i. Z, }3 `% G, J9 {2 F
*/) A5 ]$ Z+ h+ I4 g: N" ~5 K# s# W
)
3 D2 o: B" ]2 [7 {2 ~这个函数包含一个参数-指针型参数,定义及使用方法如下。, f9 a; s# X! C B. W0 |. N6 i+ Q
ProMdl mdlhandle;; K4 j) ~0 C' d/ m4 n
ProMdlCurrentGet(&mdlhandle);
$ s6 r' R6 l, U, ^1 x3 qmdlhandle 是Ohandle型参数 ,能用这个对象做许多事情。例如,能用ProMdlDataGet()做一个调用并且获得关于这个模型的一些初始信息。
: H) m; F6 }0 X8 d4 _ProMdldata mdldata;
0 q& W# l' i9 ?, W$ r6 B- f8 IProMdlDataGet (mdlhandle, &mdldata);0 |/ d% n3 u; O
mdldata是一个简单的结构体,包括名称、类型、路径和关于模型的一些其他信息。下面打印这个模型的类型。
) D. B( ^6 V# ]/ Q 不能直接执行printf("%s\n",mdldata.type),需要采用下面的方式,用ProWstringToString()把这种类型转成一种规定的字符序列:
" U3 f2 M0 ^) [# X8 x3 rchar type_in_c[PRO_TYPE_SIZE]; /* uses predefined Pro/T constants like PRO_TYPE_SIZE */' [: o* k2 Z4 e; G5 r' j
ProWstringToString (type_in_c, mdldata.type);1 m- m3 _- Z) P
printf("%s\n",type_in_c);+ O( P3 i- q3 U2 t# Y3 L4 i( c
现在打印模型的名字,就能象上面一样,从mdldata结构中取出名字,也可以用另一种的方法。* f/ T& B; K8 \( h. V) ^- K- d+ g
ProName current_name;
0 y7 T, c& J5 |( ^char current_name_in_c[PRO_NAME_SIZE]; ; c& m+ v0 G! I
ProMdlNameGet(mdlhandle, current_name);
# N$ Y( k7 v( T6 s7 j+ JProWstringToString(current_name_in_c,current_name);
5 T# l% ~) |6 T2 m5 y# R9 Gprintf("%s\n", current_name_in_c);
* _; a P- C' Q& e" c5 |/ C 接着,我们看一下访问函数。模型可能有大量包含许多子对象的对象。由于不知道这些对象的数量,需要能够以某种方式收集要寻找的对象。对于这种类型的问题,需要用到PTC提供的访问函数。. {3 f, F. k4 R' f _) x
假设想访问包含在一个模型中的所有特征并收集它们的ids。执行这个指令的函数是ProSolidFeatVisit()。其包括4个参数: ProSolid句柄、访问函数指针、过滤函数指针和应用数据的结构体指针。过滤函数的目的是能够过滤特定的对象,请看下面的例子:
8 J/ W5 q& E3 e. pstatic ProError user_action_get_feat_ids(& ~. q* t3 B6 j5 Y. v
ProFeature *feature,
- h: j1 M- Y& {- P/ E% CProError status,
) B5 x0 l$ @& y; b7 ^ProAppData appdata)1 _$ m, X& e# j
{) l* i8 R1 @, S2 f: G8 K, @
ProBoolean visible;+ r' r4 I3 W. T1 ^
vector<int> *fids = (vector<int> *)appdata;$ I/ ~: E+ g* ?6 D9 Y8 }
ProFeatureVisibilityGet(feature,&visible); /* only work with visible features */+ G' z+ R% I9 k, R
if(visible == PRO_B_TRUE){ // and collect their ids 7 o" Z( h) u2 ~% G& }8 U2 d
fids->push_back(feature->id);
! F+ `' t4 ]9 ]}
% d$ } W9 |% ^5 n1 Zreturn(PRO_TK_NO_ERROR);' L% R8 h' u' E9 u- R+ f* N
}; J* m/ V3 ]' r8 r B+ }
vector<int> feat_ids;
2 @! @+ }3 |6 U// the main Pro/TOOLKIT call
1 }8 i0 h1 j) P1 `( A5 hProSolidFeatVisit((ProSolid) mdlhandle,(ProFeatureVisitAction)user_action_get_feat_ids,NULL,(ProAppData)&feat_ids) ;注意前面提到的mdlhandle的使用,在函数调用中ProMdl 和 ProSolid能相互变换。还要注意,对于不想使用的过滤函数,赋该参数值为NULL。3 ~% B! u( ?2 o3 G
现在在feat_ids中获得一系列ids,这样就能使用它们执行一些任务,例如把它们打印出来:
. [+ z6 W5 ~4 Yfor(unsigned int i=0; i<feat_ids.size(); i++){4 ~4 x2 h4 ~/ E' N7 Z
cout<<feat_ids<<endl;
) J( N6 h$ ?; w* \8 B}' ^6 l& ]: w0 Y+ V) }5 e- |
5 结束语
- a+ \0 ]% O4 X5 q4 Z 以上提到的是需要学习Pro/TOOLKIT最基本、最常用的概念。建议学习这些例子时,可以不断变化的进行实验。另外,通过学习Pro/TOOLKIT帮助中的实例,不断深入理解大量的函数,学会其使用方法,逐步开发出用户需要的Pro/ENGINEER外挂模块,以满足特殊用户的需求 |
|