如何将 DM 脚本文件 (*.s) 转换为插件文件 (*.gtk)

Question

我写了一些 DM 脚本文件 (.s)，因此我想将它们转换（编译？）成插件文件 (.gtk)。在这种情况下，我应该准备某种编译器和 Gatan 软件开发工具包 (SDK) 包，还是其他的？如果有好的方法，请详细教下程序。如果您能分享一些创建 *.gtk 文件的智慧，我将不胜感激。

Answer 1

.GTK 文件未编译 - 将它们放在 .gtk（或 .gt1、.gt2）文件中不会获得任何速度优势。它们只是 打包 到这些文件中，以便于共享和分发它们而无需共享源代码。

也就是说，将 "pack" 脚本写入这些文件的方法是使用脚本命令本身，即编写一个脚本，从硬盘驱动器上的一组 .s 文件构建这些文件。

The command to add a script-file to a script package is AddScriptFileToPackage with the syntax:

void AddScriptFileToPackage( String file_path, String packageName, Number packageLevel, String packageLocation, String command_name, String menu_name, String sub_menu_name, Boolean isLibrary )
void AddScriptFileToPackage( String file_path, String packageName, Number packageLevel, String command_name, String menu_name, String sub_menu_name, Boolean isLibrary )

The command to add a script (string) to a script package is AddScriptToPackage with the syntax:

void AddScriptToPackage( String script, String packageName, Number packageLevel, String packageLocation, String command_name, String menu_name, String sub_menu_name, Boolean isLibrary )
void AddScriptToPackage( String script, String packageName, Number packageLevel, String command_name, String menu_name, String sub_menu_name, Boolean isLibrary )

The paramters in the two commands are:

请注意，创建的插件文件将默认出现在 user_plugin 位置：

C:\Users\USERNAME\AppData\Local\Gatan\Plugins

第二种语法允许指定路径，其中 packageLocation 参数可以是命令 GetApplicationDirectory 中也接受的任何名称，最常见的是 user_plugin（见上文） ) 或者只是 plugin 引用当前 运行 DigitalMicrograph.exe 相对插件文件夹，即

.\Plugins 相对于 DigitalMicrograph.exe 所在的位置，通常 C:\Program Files\Gatan\Plugins\

请注意，可以将脚本附加到现有文件，但不能 "unistall" 从中提取脚本。在这种情况下，必须删除该文件并重新创建它。 另外，如果待添加的脚本出现错误，将无法正确安装，您可能需要重新开始。

F1 帮助文档（后来的 GMS 版本）有一个示例脚本显示了通常如何使用该命令：

---

libary和command安装的区别与使用File-Menu命令"install a script"时一样。库通常是一组方法（或 类），安装后，这些方法在内存中保持可用。 命令 将脚本作为菜单命令安装到UI。即选择菜单执行脚本（一次）。 虽然 "File/Install Script" 将东西安装到 DigitalMicrograph 的一般首选项文件中，但上面的命令会创建单独的 .gtk 文件，如果在插件文件夹中找到，这些文件会在启动时加载。任何安装为 "library" 的代码在启动时都是 运行。