微机平台的UG二次开发技巧

　　UG/Open通过一个开放的平台包含一系列的基于UG的应用软件的柔性集成。其目的是为了计算机集成应用，实现数据共享。它具有开放的体系结构。

　　UG/Open提供了一种能够完成下列工作的应用软件和工具：1)通过UG/Open API或UG/Open GRIP提供了与UG对象模型(UG Object Model)的接口;2)生成和管理用户自定义对象(User Defined Objects或Custom Objects)，包括管理它们与UG对象的相关性;3)提供反映第三方应用软件的UG图形界面本地化方法;4)利用相关产品如IMAN ITK和Parasolid;5)利用和集成新的UG/Open技术并使之成为应用可能。

　　UG/Open API是一个允许程序访问并影响UG对象模型的程序集，并同时提供一个UG所共容的编译和联接程序的方式。它支持C/C++语言，头文件(header files)支持ANSI C。在UG软件系统中相关的还有：UG/Open GRIP(/NC), UG/Open MenuScript, UG/Open IMAN ITK和Parasolid。

　　UG/Open API执行许可证：开发运行一个UG/Open API程序需有UG/Open开发许可证和执行许可证，用户通过UF_initialize()来访问并通过UF_terminate()来返还这些许可证。

　　例程和UG/Open API头文件在用户应用平台UG安装目录下的ugopen目录里，Windows NT系统是%UGII_BASE_DIR%ugopen，用户可以访问并利用这些程序和文件。

　　一、UG/Open API在Windows NT操作系统里的安装

　　1.UG(V14.0)要求C编译器版本为Microsoft Visual C++V5.0以上，本文所述为VC++6.0版本。

　　2.定义环境变量(environment variables),定义方法：开始-设置-控制面板-系统，在“系统特性”框里点击“环境”栏，在“用户变量”里即可设置。

　　必需的环境变量：UGII_USERFCN，该变量指向UG/Open API库函数所在的目录。

　　其它的环境变量，1)变量：EXCEEDHOME，若欲使用包含UG/Open API Motif程序的prototypes的uf_ui_xt.h头文件时必须定义;2)变量：EXCEEDLIBS, 在uflink连接时指定应包含哪个eXceed/NT-XDK库函数时需定义;3)变量：INCLUDE，使C预处理器查找头文件(.h files);4)变量：LIB，它使C连接器查找对象库函数并输入库函数;5)变量：PATH，它使系统查找可执行文件、DLLs(Dynamic Link Library，动态连接库函数)和Scripts(命令表)。

　　结论，在用户变量里定义：

　　UGII_USERFCN C：ugEds140Ugopen(也可在ugii_env文件中定义)

　　EXCEEDHOME C：.ugexceed

　　EXCEEDLIBS C:ugexceedxdk

　　INCLUDE D:AppVisualStudioVC98Include

　　LIB C:ugEds140Ugopenugraf.lib;

　　C:ugEds140Ugopenuguser.lib;

　　D:AppVisualStudioVC98Lib

　　PATH C:ugEds140Ugiiog1;C:ugexceed;

　　D:AppVisualStudioVC98Bin;

　　C:ugEds140Ugii

　　2.在VC++里创建一个UG/Open API Project

　　(1)进入Microsoft Visual C++。

　　(2)创建Project: File→New→Projects，对于一个Internal UG/Open API程序选Win32 D-Link Library(对于一个Extermal UG/Open API程序选Win32 Console Application);并输入Project name。

　　(3)Configure(配置)Project Settings

　　选Project→Settings→Debug，“Category”栏是General，在“Executable for debug session”栏内输入：C：ugeds140Ugiiugraf.exe(这是为调试Internal UG/Open API program而设置的参量);在“Program arguments :”栏内输入ogl auto。

　　选Project→Settings→C/C++,在“Category：”内选Code Generation;在“Use Run-Time library：”内选Multithreaded DLL。

　　选Project→Settings→Link，“Category”栏是“general”;在“Output file name：”文本框内若无缺省输出文件名就指明;在“Object/library modules：”栏末加上ugraf.lib Xt.lib Xlibcon.lib Xlib.lib(程序为Internal UG/Open API with direct X/Motif references时)。(若程序为External UG/Open API 则加上Uguser.lib;若为Internal UG/Open API without direct X/Motif references则加上ugraf.lib)。

　　(4)Configure(配置)Tools Settings

　　选Tools→Options- →Directories，在“show directories for:”内选Include files,在“Divectories:”内输入C：ugeds140ugopen;若是Internal UG/Open API project,因要使用UG附带的支撑软件Hummingbird Exceed的include files,故再输入C：ugexceedxdkinclude。结论是依次输入：

　　C:ugEds140Ugopen

　　C:ugexceedxdkinclude

　　D:AppVisualStudioVC98Include

　　C:ugexceedLIB

　　D:AppVisualStudioVC98Mfcinclude

　　D:AppVisualStudioVC98Atlinclude

　　C:ugEds140Ugiiogl

　　C:ugEds140Ugiixwi

　　D:AppVisualStudioVintDev98bin

　　选Tools→Options- →Directories，在“show directories for:”内选Library files,在“Directories:”内输入C：ugeds140ugopen,若是Internal UG/Open API project，因要使用UG附带的支撑软件Hummingbird Exceed 的库函数，故再输入C：ugexceedxdklib。结论是依次输入：

　　C:ugEds140Ugopen

　　C:ugexceedxdklib

　　D:AppVisualStudioVintDev98bin

　　C:ugexceed

　　D:AppVisualStudioVC98Lib D:AppVisualStudioVC98Mfclib

　　C:ugEds140Ugii

　　C:ugexceedLIB

　　(5)Add Files to Project

　　为把源文件(source file)加到Project里，选Project→Add To Project→New，选文件类型(如C++ Source File)，输入File Name,这样就可以编写源文件;或者选File→New,选文件类型(如C++ Source File)，输入File Name，编写完源文件后，选Project→Add To Project→Files将该文件或其它已存的源文件加到Project里。

　　(6)Compile and Link:Compile- →Build- →Execute。

　　注：为检验上述工作是否正确，可以调出并编译运行%UGII_BASE_DIR%ugopen中的ucintr.c。

　　3.UG/Open API程序

　　(1)可执行文件(程序)类型

　　从UG/Open API里使用函数来编程可以有两种不同的模式(mode):Internal和External，这里模式是指产生的可执行代码的类型，即是一个共享库(Internal)或是一个独立的可执行代码(External)。

　　1)Internal UG/Open API的一般形式：

　　#include //Prototypes exist in this file.

　　//Additional include files as required.

　　Void ufusr(char *param, int *retcod, int parm_len)

　　{ variable declarations

　　UF_initialize();

　　Function body

　　UF_terminate();

　　}

　　Internal UG/Open API使用ufusr函数(主函数)作为程序运行的入口点，它可以看作是用户写的UG子程序/子函数。执行程序时，UG将程序装入内存并搜索ufusr, 程序从这里开始执行，执行完后由一个return语句返回UG。

　　2)Extermal UG/Open API的一般形式：

　　#include

　　//Additional include files as required.

　　Int main(int argc, char **argv)女

　　{ variable declarations

　　UF_initialize();

　　Function body

　　UF_terminate();

　　}

　　输入主函数的参数(arguments)是标准的C参数：argc- argument count, argv-字符串指针。

　　(2)几点说明

　　1)头文件(*.h file) 在程序中除了包含标准的ANSI C头文件外，还应包含所 使用的UG/Open API程序的头文件，在这些特定的头文件里描述了UG所称的“Types 和Symbols”，即用来定义结构体(structures)、枚举体(enums)、共用体(unions)和指针(pointers)的“类(type)”和用来定义常量(constants)的“串(string)”。

　　2)程序的运行 一般地，可以从在UG图形界面里来运行，另外地可以从UG/Open MenuScript、User Exits、User Tools和UG/Open GRIP里调用并运行。

　　3)函数(Functions)UG/Open API提供的函数形式和ANSI/ISO C标准相一致，即<返回数据类型> <函数名> (变量表)

　　(3)UG对象模型(UG Object Model)

　　UG使用许多方法为其对象建立模型，根据对象的不同用途及其相互关系，UG对象可以是面向设计(design-oriented)、面向工程图(drafting-oriented)、面向分析(analysis-oriented)或者面向制造(manufacturing-oriented)的对象。UG开发人员编程的过程实际上就是访问、修改、植入UG对象从而建立起UG对象模型的过程。

　　每一个UG对象都是通过其唯一的标识符(identifier)(如tag)来引用，一个标示符的实际物理表示是一个无符号型整型变量(unsigned integer)。tag 在UG/Open API头文件uf_defs.h里被定义，它仅仅是把一个UG对象载入内存时的标示符。