|
1 前言 Pro/TOOLKIT是Pro/ENGINEER的一个应用程序接口(API),其的编程语言是C 语言,它可以对Pro/ENGINEER进行功能扩展,满足PTC客户的特定需求。而且,Pro/TOOLKIT提供了定制标准Pro/ENGINEER用户界面的能力,自动执行重复性的程序,通过Pro/ENGINEER集成的内部程序(Dll)或外部应用程序(Exe)可以为造型用户提供自定义的应用程序、设计规划和绘图自动化。$ Z. `9 J2 h- x% H1 y
2 Pro/TOOLKIT编程条件和工具. A; t3 h6 w; w' K& v
知道如何写C程序,就已经具备了使用Pro/TOOLKIT的条件,应该能够理解指针,当把数据从一个函数传到另一函数时,将经常使用到它。Pro/TOOLKIT帮助,包含2000多个函数,并且可以通过例子代码学习如何使用。除此之外,如果想解决几何学问题,还需要对失量理论有一定的了解。
% i% [# j4 h" m& s3 Pro/TOOLKIT程序中的结构体
* X o, D N0 j1 _- ?1 I Pro/TOOLKIT都是用C语言编写的,每个对象都用结构体来描述,因此需要了解对象是如何使用的。为了使用结构体,需要定义它,Pro/TOOLKIT提供许多“typedefs”,这些typedefs只不过是Pro/ENGINEER结构体的伪指令。例如:! q* P r+ ]8 _
typedef struct entity* ProPoint;
* y2 s, m% D3 T! K' M. E% Ktypedef struct sld_part* ProSolid;
$ u o- I, p1 l* K: J: q 这些也叫做OHandles (from Opaque handles),在Pro/ENGINEER中它们直接获得对象的内存地址。在某些情况下,这样做可能是危险的,因此PTC提供了另外一种结构体类型,它只包含Pro/ENGINEER的内部数据库中项目的必要信息。这种结构体(labeled DHandle from data handle)是一种类的结构,它包括对象的类型、ID等。许多函数命令都和下面的结构体相联系。4 y9 A; ~9 L' u7 N. s& d
typedef struct pro_model_item
! k4 r1 O% {" g" G2 Y{0 S/ f% {+ i& d5 ~+ t3 T
ProType type;
# v' \( ~3 ]) w8 E/ U( }int id;6 [2 _. d6 a1 b) W/ g
ProMdl owner;
@+ p6 ]. I# P" W) ^}ProModelitem,ProGeomitem,ProExtobj, ProFeature,ProProcstep,ProSimprep,ProExpldstate,: C2 ]! \/ u& x# F
ProLayer,ProDimension,ProDtlnote,ProDtlsyminst,ProGtol,ProCompdisp
E2 w7 h q1 B% `' N& j
U* M$ [- J. ]! F. D& @; S 如果处理几何问题,要用到ProModelitem、ProGeomitem 和ProFeature这几个结构体。& W/ [. ^+ u. C1 U+ ?, X& w
4 Pro/TOOLKIT中的常用函数及使用
6 }2 k' V! s; o, @, u! B8 E 需要了解的第一个函数是ProMdlCurrentGet()。在Pro/TOOLKIT帮助中其描述如下。
# ?! x/ s: l" T. `Description$ M, \5 _+ s3 F% b/ V+ s
Initializes the p_handle with the current Pro/ENGINEER object.
+ P2 C2 @; W* p' V5 K. k0 R/ `Synopsis
0 Q+ z0 s, v3 O#include <ProMdl.h>
' C1 r% I ?9 H. t) EProError ProMdlCurrentGet (
' w. D8 C3 h6 h/ C$ HProMdl *p_handle1 q' ^+ ~& f$ C, f4 H
/* (Out)
3 N# e/ [- f, [2 n" W WThe model handle& H! r8 m0 b; L
*/
2 a% m i5 v$ X. w/ N2 D$ ?0 w)/ \% F! e2 }1 p) T3 U
这个函数包含一个参数-指针型参数,定义及使用方法如下。
/ i4 t% }; [+ u- Z- S# fProMdl mdlhandle;
( t0 j* }7 N8 {6 iProMdlCurrentGet(&mdlhandle);
' I g7 { Y! e# F" A/ g1 tmdlhandle 是Ohandle型参数 ,能用这个对象做许多事情。例如,能用ProMdlDataGet()做一个调用并且获得关于这个模型的一些初始信息。. q. e8 d) O# c1 i
ProMdldata mdldata;6 p) Z D: N7 \; d
ProMdlDataGet (mdlhandle, &mdldata);
9 O |6 ~- F7 e" C" H4 w mdldata是一个简单的结构体,包括名称、类型、路径和关于模型的一些其他信息。下面打印这个模型的类型。# [+ L/ @4 l5 a
不能直接执行printf("%s\n",mdldata.type),需要采用下面的方式,用ProWstringToString()把这种类型转成一种规定的字符序列:# p. D. W' T8 C/ w' i
char type_in_c[PRO_TYPE_SIZE]; /* uses predefined Pro/T constants like PRO_TYPE_SIZE */; y, O, `; V- Q9 j
ProWstringToString (type_in_c, mdldata.type);
0 m; {& R/ e8 v8 U( P9 U7 @printf("%s\n",type_in_c);
8 c/ `/ a2 @7 W. a$ H+ C5 S 现在打印模型的名字,就能象上面一样,从mdldata结构中取出名字,也可以用另一种的方法。
& B7 @3 |9 D) n% fProName current_name;
) ]4 i/ {# |* W% W3 N) Y* achar current_name_in_c[PRO_NAME_SIZE];
/ `$ b( p1 l3 E LProMdlNameGet(mdlhandle, current_name);% ~$ E$ T0 N0 w$ ^' v* S( D
ProWstringToString(current_name_in_c,current_name);4 e1 d1 ~/ I2 Z
printf("%s\n", current_name_in_c);4 F$ p: K% X9 s. ^4 o& r* S7 d1 S
接着,我们看一下访问函数。模型可能有大量包含许多子对象的对象。由于不知道这些对象的数量,需要能够以某种方式收集要寻找的对象。对于这种类型的问题,需要用到PTC提供的访问函数。
' d; g- S# U1 |, f 假设想访问包含在一个模型中的所有特征并收集它们的ids。执行这个指令的函数是ProSolidFeatVisit()。其包括4个参数: ProSolid句柄、访问函数指针、过滤函数指针和应用数据的结构体指针。过滤函数的目的是能够过滤特定的对象,请看下面的例子:
?( S1 S5 ?% F& wstatic ProError user_action_get_feat_ids(' s9 g! c4 Z T6 {
ProFeature *feature,7 T" J; ~% I* P4 o* N9 d
ProError status,- f# \9 u2 x U O3 o5 T
ProAppData appdata)3 A2 d" s" G: K2 m8 M; S5 e K4 R1 a
{
6 M3 h+ a9 E4 \! eProBoolean visible;
4 |! p, C- Y3 c8 L% E. T2 Dvector<int> *fids = (vector<int> *)appdata;% `2 |( I! B! z/ t
ProFeatureVisibilityGet(feature,&visible); /* only work with visible features */
; }5 _; a1 B/ D' c, V! ?* u. T6 sif(visible == PRO_B_TRUE){ // and collect their ids
+ v! m8 O' U$ [9 { i/ Lfids->push_back(feature->id);
4 R0 P# }$ w. V9 W# g, c} D( |( E1 J8 B9 d
return(PRO_TK_NO_ERROR);
& q" w* i, _, D }$ S8 K) h B- K# X8 y" R
vector<int> feat_ids;# H, Q7 N0 O* a6 i
// the main Pro/TOOLKIT call. H4 U+ _3 J1 E2 ?
ProSolidFeatVisit((ProSolid) mdlhandle,(ProFeatureVisitAction)user_action_get_feat_ids,NULL,(ProAppData)&feat_ids) ;注意前面提到的mdlhandle的使用,在函数调用中ProMdl 和 ProSolid能相互变换。还要注意,对于不想使用的过滤函数,赋该参数值为NULL。2 r ]% ^* Z7 ~, F6 s1 Z
现在在feat_ids中获得一系列ids,这样就能使用它们执行一些任务,例如把它们打印出来:6 f/ }0 V2 G5 A2 D
for(unsigned int i=0; i<feat_ids.size(); i++){
* `* O) r# N0 tcout<<feat_ids<<endl;
5 F ^/ I4 r8 Z% j2 u}
* u( k' K3 u$ F5 结束语
0 K$ D8 [( b! \$ \+ i' b 以上提到的是需要学习Pro/TOOLKIT最基本、最常用的概念。建议学习这些例子时,可以不断变化的进行实验。另外,通过学习Pro/TOOLKIT帮助中的实例,不断深入理解大量的函数,学会其使用方法,逐步开发出用户需要的Pro/ENGINEER外挂模块,以满足特殊用户的需求 |
|