User Tools

Site Tools


gui:plugins:compile_and_run

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

gui:plugins:compile_and_run [2019/04/12 11:13] (current)
Line 1: Line 1:
 +====== Compile and Run... ======
  
 +**Compiles and runs a plugin. ​ Requires that ImageJ be running on a Java Virtual Machine that includes the javac compiler.**
 +
 +Runs a plugin if the name of the selected file ends in "''​.class''",​ otherwise tries to compile a java file. Hold down the **Alt** key while running this command to have the javac compiler generate the debugging infomation required for monitoring variables using debuggers such as NetBeans and Eclipse. You can also use **//Edit > Options > Compiler//​** to create ''​.class''​ files for debugging. There, you can also select the Java version of the ''​.class''​ file.
 +
 +Use an underscore in the filename (and the class name) if you want that ImageJ loads your plugin automatically on startup (or when selecting //**Help > Update Menus**//). The underscore character will be converted into an space in the Plugins menu, e.g. ''​Example_Plot.class''​ will appear as menu item "​Example Plot".
 +
 +If your plugin accesses a package contained in a jar file located in the plugins folder, this jar file must **not** contain an underscore.
 +
 +===== Javac setup =====
 +
 +**Javac** is included with the Windows and Linux versions of ImageJ that come bundled with a Java runtime. It is also included with Mac OS X Java.
 +
 +Users of Sun's Java 2 SDK (Software Development Kit) for Windows, Linux and Solaris must add ''​tools.jar''​ to the command line that runs ImageJ.
 +
 +Here is an example Windows command line for running ImageJ using the Java 2 SDK (aka JDK):
 +
 +  java -mx100m -cp ij.jar;​C:​\jdk1.4\lib\tools.jar ij.ImageJ
 +
 +It assumes the Java 2 SDK is installed in C:\jdk1.4.
 +
 +On a Unix system, the command would look something like this:
 +
 +  java -mx100m -cp ij.jar:​\usr\local\jdk1.4\lib\tools.jar ij.ImageJ
 +
 +The -mx100 options specifies that ImageJ can use up to 100MB of RAM. To avoid virtual memory thrashing, this value should not be set to more than 2/3 of available RAM (e.g. -mx170m on a 256MB machine).
 +
 +On Windows, you can create a double-clickable shortcut that uses Java 2 to run ImageJ: ​
 +
 +  - Right-click on the desktop and select New->​Shortcut from the menu
 +  - Enter:​\\ ​ javaw -mx100m -cp ij.jar;​C:​\jdk1.4\lib\tools.jar ij.ImageJ as the "​Command line"; click "​Next"​
 +  - Enter a name for the shortcut (e.g. "​ImageJ"​);​ click "​Finish"​
 +  - Right-click of the newly created shortcut and select Properties from the menu
 +  - Click on the Shortcut tab
 +  - Enter the path to the ImageJ folder (normally C:\ImageJ) in "Start in"; click "​OK"​
 +
 +"​**javaw**"​ is a variation of the java command that runs Java applications without a DOS windows.
gui/plugins/compile_and_run.txt ยท Last modified: 2019/04/12 11:13 (external edit)