几何尺寸与公差论坛

 找回密码
 注册
查看: 4971|回复: 0

【转帖】ug/open Api简明教程

[复制链接]
发表于 2004-4-28 17:21:38 | 显示全部楼层 |阅读模式
User Functions培训简明教程
第一章 绪论

1 User Function是什么

定义:在UG中用C语言开发应用程序的一个工具

2 User Function的两种形式

External (执行程序) Internal (动态连接库)

3 User Function的组成与相互关系

User Function可以分为以下几个部分:
菜单
对话框
应用程序(回调函数)
C语言库函数
(1) 创建与查询几何实体
(2) 分析几何实体
(3) 创建与编辑特征
(4) 创建与编辑表达式
(5) 数据管理
这几部分的关系可以作如下的描述:
User Functions的菜单和对话框是程序与用户交互的工具,从菜单可以起动应用程序,对话框等,在对话框激活控件时,将调用相应的回调函数,回调函数和控件的关系在UIStyler 中定义。应用程序和回调函数用基本的C语言和User Functions的库函数编码。

4 User Functions的执行

User Functions的执行包括四种形式:
(1) FileExecute UG/OPEN
User Functions 选取该菜单将出现一个文件打开对话框,选取相应用应用程序即可。
(2) Menu ACTION
(3) UIStyler 回调函数
(4) 将应用程序COPY到UGII_USER_DIR\startup子目录下,应用程序将在UG启动时自动运行。

5 User Functions的开发步骤

有关软件工程方面的内容,不是我们要介绍的内容,要讲的是User Functions有关的开发步骤。在下面讲述的内容是以NT下的Visual C++ 5.0和UG15.0为支持环境。
具体的开发步骤如下:
(1) 建立C源程序
(2) 在Visual C++中建立一个project
(a).Create new project FileNew projectWin32 Dynamic-Link Library 此时还要输入project的名称。
(b).配置编译Option Projectsetting C/C++Code generationMultithreaded DLL
(c).配置LINK options ProjectsettingLINKObject/Library modules在增加两个库libufun.lib和libinternal.lib (这两个库替换原来的ugraf.lib)
(d).配置include path tooloptionsdirectoriesinclude files中增加 c:\ugs150\ugopen (该目录为UG15的安装目录,要根据安装情况定)
(e).配置library path tooloptionsdirectorieslibrary files中增加c:\ugs150\ugopen( 该目录为UG15的安装目录。
(f). 增加files projectadd To projectfiles 选择相应的C源文件。
(g).配置Debug Options ProjectsettingsDebug Executable for debug session 输入c:\ugs150\ugii\ugraf.exe ProjectsettingsDebug Working director 输入一任意工作路径 ProjectsettingsDebug program arguments 输入 ogl auto 如果不需要调试程序,(g)可以不作。
以上步骤主要是指不用UIStyper开发应用程序,其程序的执行可以直接用4中所讲述的方法(1)。如果用UIStyler开发应用程序,可以用ApplicationUser Interface Styler设计一个对话框,UG会自动生成C源程序的框架结构,用户可以在程序中增加相应的内容,使应用程序完成不同的工作。有关此类程序的执行一些注意事项参考UGII_USER_DIR环境变量的内容。

6 与User Functions有关的环境变量

UGII_USER_DIR :可以指向文件系统的任意路径。在该环境变量指定的目录中,有三个子目录,即startup、application和udo。在startup子目录下的动态连接库文件(在NT下为*.DLL),菜单定义文件(*.men)将在UG启动时自动运行。而application子目录则是UG在装载自定义菜单时,ACTIONS所指定的menu文件,dlg文件和动态连接库文件的缺省路径,也就是说在menu文件指定的这些文件都要COPY到application子目录下,否则系统会有错误提示。

第二章 应用程序的界面设计

第一节 MenuScript

MenuScript是用户修改,增加和创建新的用户菜单的工具,用它可以对标准的UG_GATEWAY_MAIN_MENUBAR和UG_GATEWAY_VIEW_POPUP菜单进行修改和编辑。下面是一些常用的语句。
CREATE :创建一个新的菜单
EDIT :编辑一个菜单
BUTTON :按钮
CASCADE BUTTON:下拉式按钮
SEPERATION :分隔符
TOGGLE BUTTON:复选按钮
BEFORE 和 AFTER:指明菜单的位置
MODIFY :修改一个菜单 ACTIONS它可以跟以下内内容
STANDARD----它指向标准的UG应用
User-Defined Callback----它指向用户定义的回调函数
UIStyler dialog ---- 它指向一个UIStyler 对话框
GRIP Program File ----- 它指向一具GRIP 程序

EXAMPLE1:

VERSION 120
EDIT UG_GATEWAY_MAIN_MENUBAR

BEFORE UG_HELP
CASCADE_BUTTON LAUNCH_CASCADE
LABEL Dialog Launcher
END_OF_BEFORE

MENU LAUNCH_CASCADE
BUTTON DEMO_BTN
LABEL Display demo dialog
ACTIONS demo
END_OF_MENU

MENUSCRIPT_FILE_ID PVFKENPPAC

EXAMPLE2:

VERSION 120
EDIT UG_GATEWAY_MAIN_MENUBAR

MODIFY APPLICATION_BUTTON
UG_APP_MODELING LIBRARIES ufx_menuscript_ufsta.sl
MENU_FILES/APPEND ufx_menuscript_modeling.men
END_OF_MODIFY

MENUSCRIPT_FILE_ID PPDMERMPAG

第二节 UIstyler

1. UIstyler对话框设计工具

有关对话框设计工具的使用请参考用户手册。

2. UIstyler编程

用UIStyler编辑一个对话框,系统自动生成三个文件,一是C语言源文件的框架,也即给出了每个回调函数的框架,回调函数具体的操作,则需用户自己加入;一是定义函数原型的C头文件(*.h),一个对话框文件(*.dlg)。 两个函数常用的函数:UF_STYLER_ask_value( ……) UF_STYLER_set_value(……) 作业: 用UIStyler设计一个对话框,并用Visual C++工具调试该程序。

第三章 User Function的一些基础操作

1 User Function程序的Format

#include void ufusr ( char *param , int *retcode, int param_len ) { int irc; irc = UF_initialize() ; // 在这里加入用户的程序 irc = UF_terminate() ; }

2 文件操作

User Function提供了些进行prt文件处理的函数,可用于prt文件的open, close,new, save, save as, 得到工作零件,设置工作零件,import 、export文件等操作。常用的函数包括 UF_PART_open UF_PART_ask_num_parts UF_PART_save_all UF_PAET_close_all UF_PART_ask_part_name UF_PART_ask_part_tag UF_PART_ask_display_part UF_PART_set_display_part 有关这些函数的使用可参考USER MANUAL。

3 程序message的显示

User Function几乎所有的函数都返回一个INT型的数,为0时表明执行正确,非0时可用UF_get_fail_message函数得到出错信息,用UF_UI_set_status将错误显示在状态行,用UF_UI_set_prompt将错误显示在提示行,UF_UI_display_nonmodal_msg函数可以显示一具提示对话框。

4 内存管理

在User Function的一些函数返回值分配了内存,需要程序释放内存(函数说明中标明OF),可用UF_free和UF_free_string_array完成。

5 标准对话框

User Function定义了很多标准的对话框,可进行交互输入,选择等操作,如:uc1616 调用点subfunction对话框输入一个点 UF_UI_select_by_class UF_UI_select_single 除些以外还有大量的函数,可在uf_ui.h中找到。

第四章 装配和建模

1 有关装配的几个概念

Piece
Part 零件
Occurrence(part Occurrence and object Occurrence) 事件
Instance 实例
Component part 装配中的一个part可以是零件和子装配
Reference set 实体集,用于简化表示
Displayed Part Work Part 工作零件
Portotype 指向装配中零件的原型


2 有关装配和建模的函数说明表参阅相关的USER MANUAL

3 作业 part1和part2都是平板零件,part3是part1和part2的装配,现要求在part3中选择part1或part2或part1和part2,并用一个足够长的圆柱体在选中的part1和part2上打一个通孔。
程序的过程如下:
1 UF_initialize() ;
2 用 UF_ASSEM_ask_work_part()和 UF_ASSEM_ask_root_part_occ( old_tag )确定当前工作零件是否为装配文件。
3 用UF_UI_select_single(…….)选择零件;opts的scope设为 UF_UI_SEL_SCOPE_ANY_IN_ASSEMBLY。
4 用uc1608输入直径、X和Y值;
5 用UF_MODL_create_cyl1()创建一个圆柱体,用 UF_MODL_ask_feat_body()得到feature的ID;
6 用UF_ASSEM_ask_part_occurrence( )得到part的原型。 用UF_ASSEM_ask_prototype_of_occ( )求part的tag和物体的tag;
7 用UF_MODL_operations求交;
8 用UF_terminate()
结束;

第五章 尺寸

尺寸可以在drawing中生成,也可以在model view生成,在关draft的尺寸标注,首先是几个参数设置和获取的函数。 UF_DRF_ask_object_preferences UF_DRF_ask_preferences UF_DRF_set_object_preferences UF_DRF_set_preferences 常用的函数包括: UF_DRF_create_horizontal_dim UF_DRF_init_object_structure UF_DRF_create_vertical_dim Uc5540 Create a Note UF_DRF_create_label 有关函数的说明请参考用户手册。
您需要登录后才可以回帖 登录 | 注册

本版积分规则

QQ|Archiver|小黑屋|几何尺寸与公差论坛

GMT+8, 2024-7-24 13:43 , Processed in 0.038800 second(s), 19 queries .

Powered by Discuz! X3.4 Licensed

© 2001-2023 Discuz! Team.

快速回复 返回顶部 返回列表