A simple Maven project implementing an ImageJ 1.x plugin
Java
Pull request Compare This branch is 4 commits ahead, 15 commits behind imagej:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
src/main
.gitignore
README.md
pom.xml

README.md

##This is a minimal Maven project implementing an ImageJ 1.x plugin

It is intended as an ideal starting point to develop new ImageJ 1.x plugins in an IDE of your choice. You can even collaborate with developers using a different IDE than you.

  • In Eclipse, for example, it is as simple as File>Import...>Existing Maven Project . For more details, see this page.

  • In Netbeans, it is even simpler: File>Open Project. The same works in IntelliJ.

  • If jEdit is your preferred IDE, you will need the Maven Plugin.

  • Die-hard command-line developers can use Maven directly by calling mvn in the project root.

However you build the project, in the end you will have the .jar file (called artifact in Maven speak) in the target/ subdirectory.

To copy the artifact into the correct place, you can call mvn -Dimagej.app.directory=/path/to/Fiji.app/. This will not only copy your artifact, but also all the dependencies. Restart your ImageJ or call Help>Refresh Menus to see your plugin in the menus.

Developing plugins in an IDE is convenient, especially for debugging. To that end, the plugin contains a main() method which sets the plugins.dir system property (so that the plugin is added to the Plugins menu), starts ImageJ, loads an image and runs the plugin. See also this page for information how Fiji makes it easier to debug in IDEs.

Since this project is intended as a starting point for your own developments, it is in the public domain.

##How to use this project as a starting point

Either

Then:

  1. Edit the pom.xml file. Every entry should be pretty self-explanatory. In particular, change
    1. the artifactId (and optionally also groupId)
    2. the version (note that you typically want to use a version number ending in -SNAPSHOT to mark it as a work in progress rather than a final version)
    3. the dependencies (read how to specify the correct groupId/artifactId/version triplet here)
    4. the developer information
    5. the scm information
  2. Remove the Process_Pixels.java file and add your own .java files to src/main/java/<package>/ (if you need supporting files -- like icons -- in the resulting .jar file, put them into src/main/resources/)
  3. Edit src/main/resources/plugins.config to set where the plugin appears in the ImageJ menu.
  4. Replace the contents of README.md with information about your project.

Eclipse Tip: To ensure that Maven copies the plugin to your Fiji folder

  1. Go to Run>Run Configurations...
  2. Choose your run configuration under Maven Build
  3. Add the following parameter: name: imagej.app.directory value: /<path>/<to>/Fiji.app/

This ensures that the final .jar file will also be copied to your Fiji plugins folder everytime you run the Maven Build. Detailed Instruction.

Publishing your project

If you cloned the minimal-ij1-plugin repository, you probably want to publish the result in your own repository:

  1. Call git status to verify .gitignore lists all the files (or file patterns) that should be ignored
  2. Call git add . and git add -u to stage the current files for commit
  3. Call git commit or git gui to commit the changes
  4. Create a new GitHub repository
  5. git remote set-url origin git@github.com:<username>/<projectname>
  6. git push origin HEAD