Adams 2013自定义插件方法zz

1.Adams插件介绍

Adams的高级模块（如Controls控制模块、Vibration振动模块、Durability耐久性模块等）是以插件的形式集成在Adams软件中。通过Adams提供的插件管理器（Plugin Manager）工具能非常方便地对这些插件进行管理，即插即用，激活或失效插件，扩展应用领域。

在进行Adams二次开发定制客户化程序后，把所开发的程序做成一个插件，能非常方便地加载或卸载，方便使用。

2.Adams自定义插件方法

为方便操作和重复使用，Adams的操作过程使用脚本语言实现。交互式操作同样可以实现，这里不再阐述。

2.1 创建library

首先创建一个library库，后续所有的二次开发的程序都放在此库中。创建一个名为example_plugin的库的脚本代码为：

if condition = (eval(!db_exists(".example_plugin ")))

library create library_name = . example_plugin

end

完成后，可以在Database Navigator中查看所建的库。

2.2 编写二次开发程序

使用Adams编程语言、Macro宏命令或者Dialog Box对话框编程技术进行Adams软件的二次开发，实现客户定制化程序。

本文使用对话框编程技术开发一个对话框，如下图所示。

注意：所有开发的程序都需要包含在上述所建的example_plugin库中。为了使用方便，建议使用编程的方式进行软件开发。

2.3 创建自定义菜单

创建Adams自定义菜单和命令按钮，并关联上一步中创建的对话框程序。定义新创建的菜单变量名称是example，显示的菜单名是Myplugin；定义创建的按钮显示名称为Line of Markers，使用commands命令把该按钮与对话框关联起来。详细的命令程序如下：

　interface menu create menu_name = .gui.main.mmenu_menu.mbar_refresh.example  label = "MyPlugin"

interface push_button create push_button_name = .gui.main.mmenu_menu.mbar_refresh.example.button_1 &

label = "Line of Markers" &

commands = "interface dialog display dialog=.example_plugin.dbox_1"

使用下面的程序实现自定义菜单的加载和卸载。注意，此处宏的名称是固定的，必须是“库文件名.load”和“库文件名.unload”这种命名才可以，否则不能实现插件的加载和卸载。

 

 

2.4 生成Bin二进制文件

上述所创建的程序都包含在example_plugin库中，需要把此库文件和创建的菜单一起生成为Bin格式的二进制文件，具体程序如下：

file binary write &

file_name = "example_plugin.bin" &

entity_name = .example_plugin, &

.gui.main.mmenu_menu.mbar_refresh.example

运行上述命令后，会在Adams工作路径文件夹中生成名称为example_plugin.bin的文件，

注意：文件的名称有严格要求。要求插件的名称、Library库文件名称、二进制文件名称以及XML文件名称必须相同。例如，插件名称是example_plugin，则库文件名称必须是example_plugin，二进制文件example_plugin.bin，XML文件的名称是example_plugin_plg.xml。

2.5 定义XML文件

由于定义的库文件名称是example_plugin，所以XML文件的名称必须是example_plugin_plg.xml，否则插件不能正常使用。

XML文件详细代码为：

该文件必须和example_plugin.bin文件放在同一个文件夹中，可以放在Adams安装路径下（如D:\MSC.Software\Adams_x64\2013\win64），这样启动Adams时自动加载该插件；也可以放在Adams的启动目录中， Adams在此目录启动时会自动加载该插件，本文把这两个文件放在Adams启动路径中。

2.6 使用自定义插件

启动Adams 2013，打开Plugin Manager插件管理器，会出现自定义的example_plugin插件，加载该插件生成菜单，点击菜单按钮弹出自定义的对话框。

以上步骤完成自定义插件的实现。

注意：本文所有的操作是在Adams 2013版本默认界面中完成，由于Adams新旧界面有很大的变化，如果使用旧界面的Adams，创建自定义菜单的程序需要稍作修改，其他程序都是相同的。