ImageJ 用户手册——第三部分（ImageJ扩展）

ImageJ扩展

ImageJ功能可以通过宏、脚本或插件形式的可加载代码模块进行扩展。ImageJ网站提供了300多个宏、500多个插件和20多个脚本。以下是对这三种类型的ImageJ附加组件的简短描述：

• 宏（Macros）——执行一系列ImageJ命令的最简单方法。ImageJ宏语言是一种类似Java的语言，包含一组控制结构、运算符和内置函数，可用于调用内置命令和其他宏。宏代码存储在文本文件中（扩展名为.txt和.ijm）。
• 插件（Plugins）——比宏功能强大、灵活、快速得多（ImageJ的大多数内置菜单命令实际上都是插件），但更难编写和调试。
• 脚本（Scripts）——ImageJ使用Mozilla Rhino解释器来运行JavaScripts。与插件类似，脚本可以完全访问所有ImageJ和Java API，但不需要编译（脚本和宏以解释方式运行）。另一方面，脚本缺乏宏语言的简单性，在ImageJ中的集成度较低。

14. 宏指令（Macros）

宏是一个简单的程序，可以自动执行一系列ImageJ命令。创建宏的最简单方法是使用命令记录器记录一系列命令。宏将保存为文本文件（扩展名为.txt或.ijm），安装后，通过在Plugins>Macros>submenu中选择宏名称、按键执行，或者在使用宏工具的情况下，通过单击ImageJ工具栏中的图标执行。此外，任何放置在ImageJ/plugins中的扩展名为.ijm的宏文件都将像任何其他插件一样安装在Plugins>menu中。

ImageJ网站上有300多个示例宏。要尝试一个，请在浏览器窗口中打开它，并将其直接拖动到Main ImageJ窗口，或者将其复制到剪贴板，切换到IJ，然后运行File.New.System剪贴板，将宏粘贴到新的编辑器窗口中。使用编辑器的Macros>Run Macro命令运行它。大多数示例宏也可以在ImageJ文件夹中的宏文件夹中找到。

宏程序设计

ImageJ社区创建了关于宏编程的优秀教程。这些资源是ImageJ宏语言不可或缺的指南：

1. The ImageJ Macro Language — Programmer’s Reference Guide（ImageJ宏语言-程序员参考指南）：这本小册子汇编了分布在网络上的与ImageJ的宏编程相关的大部分文档。它为ImageJ宏语言提供了最新的可打印手册：http://imagej.nih.gov/ij/docs/macro_reference_guide.pdf
2. 内置宏函数网页（编辑器中的Help>Macro Functions and Macros>Function Improved Finder）是可以从ImageJ宏语言调用的内置函数的不可或缺的指南。它有完整的文件记录并不断更新：http://imagej.nih.gov/ij/developer/macro/functions.html
3. Fiji网页上的教程：http://fiji.sc/wiki/index.php/Introduction_into_Macro_Programming
4. ImageJ文档门户网站上的操作方法和教程：http://imagejdocu.tudor.lu/

15. 脚本（ Scripts）

ImageJ 1.41中引入了JavaScript脚本，以实现对ImageJ和Java API的完全访问。ImageJ使用Java 1.6 for Linux和Windows内置的Mozilla Rhino解释器来运行JavaScript。Mac用户和Java早期版本的用户必须将JavaScript.jar下载到插件文件夹中。这个JAR文件可以在ImageJ网站上找到，并且包含在ImageJ/plugins/jars中的ImageJ的Mac版本中。

示例JavaScript程序可在imagej.nih.gov/ij/macros/js/上找到。可以使用Recorder（Plugins>Macros>Record）生成线程安全的JavaScript代码。脚本可以在编辑器中作为任何其他宏打开。扩展名为.js的脚本可以使用Macros>Run Macro 来运行，否则必须使用Macros>Evaluate JavaScript 。

JavaScript编程

关于ImageJ JavaScript脚本的资源包括：

1. ImageJ网站，文档不断增加：http://imagej.nih.gov/ij/developer/javascript.html
2. Fiji网页上的教程：http://fiji.sc/wiki/index.php/Javascript_Scripting
3. 在线脚本存储库：http://imagej.nih.gov/ij/macros/js/

16. 插件（ Plugins）

插件是一个比宏和脚本强大得多的概念，而且ImageJ的大多数内置菜单命令实际上都是作为插件实现的。引用维尔纳·拜勒的话：插件被实现为Java类，这意味着您可以使用Java语言的所有功能，访问完整的ImageJ API，并在插件中使用所有标准和第三方Java API。这为插件中可以做的事情提供了广泛的可能性。插件最常见的用途是对图像或图像堆栈执行一些分析或处理的过滤器，以及用于从文件或其他设备读取/写入本机不支持的格式的I/O插件。但正如您在查看ImageJ插件页面上列出的插件时所看到的，您可以使用插件做许多其他事情，例如渲染图形或创建ImageJ图形用户界面的扩展。

ImageJ/Plugins/文件夹中的插件列在Plugins>menu的底部。只有插件文件夹中名称中至少有一个下划线的.class和.jar文件才会被安装。请注意，在IJ 1.44d及更高版本中，ImageJ不再在启动时自动在以小写字母开头的JAR文件目录中安装插件。

开发ImageJ插件

有关如何开发ImageJ插件的更多信息，请访问以下文档：

1. ImageJ网站上的开发人员资源页面：http://imagej.nih.gov/ij/developer/index.html
2. Fiji网页上的专用教程：http://fiji.sc/wiki/index.php/Introduction_into_Developing_Plugins
3. ImageJ文档门户网站上的专用教程：http://imagejdocu.tudor.lu/
4. ImageJDev网页上的专用教程：http://developer.imagej.net/ides

17. 用其他语言编写脚本

使用Fiji及其强大的编辑器，ImageJ可以支持其他语言。Fiji增加了对BeanShell、Clojure、Python和Ruby的额外支持。以下文档将向您介绍Fiji的高级脚本功能：

1. Albert Cardona关于用Jython编写Fiji脚本的广泛教程：http://www.ini.uzh.ch/~acardona/fiji-tutorial/
2. Fiji网页上的专用教程：http://fiji.sc/wiki/index.php/Scripting_comparisons

Fiji脚本编辑器

Fiji拥有比ImageJ内置编辑器更强大的脚本编辑器。当使用Fiji支持的任何语言（包括ImageJ宏语言）编写脚本时，Fiji编辑器都是一个宝贵的帮助。该编辑器具有完全撤消支持、语法高亮显示、选项卡、书签和其他一些简化ImageJ中脚本工作流程的工具。欲了解更多信息，请访问Fiji
http://fiji.sc/wiki/index.php/Script_Editor编辑网站
。

18. 从命令行运行ImageJ

ImageJ是作为桌面应用程序设计的。然而，它可以在没有图形环境（headless模式）的情况下运行，方法是在ij.jar类路径中添加一个特殊的库（headless.jar），该库覆盖关键的ImageJ类以更好地无图形化工作。

ImageJ识别以下命令行选项：

• “file-name”：打开一个文件
• -ijpath path：指定包含插件目录的目录路径
• -port：指定ImageJ用于确定另一个实例是否正在运行的端口。
• -macro path [arg]：运行宏或脚本，向其传递一个可选参数，该参数可以使用getArgument（）进行检索。
• -batch path [arg]：以批处理模式（无GUI）运行宏或脚本，并向其传递可选参数。当宏结束时，ImageJ退出。
• -eval “macro code”：计算宏代码。
• -run command：运行ImageJ菜单命令
• -debug：在调试模式下运行ImageJ。