Eclipse installation and configuration documentation
First, download it from http://www.eclipse.org/. We have confirmed that the full Eclipse install works, although the Eclipse for Java development may also work.
Install the subclipse plugin (see http://subclipse.tigris.org/ for instructions). You may have to unselect the optional Buckminster and Mylyn integration features to get subclipse to install.
Note that the Java SDK, JOGL and Java3D must be installed before proceeding (make sure that the dlls and jars for JOGL and Java3D are installed properly into the JDK you are planning to use).
Open the SVN Repository Exploring perspective (Window -> Open Perspective -> Other...) and right click on the panel on the right to add a new repository location (https://citdcbmipav.cit.nih.gov/repos/mipav for NIH users, replace 'repos' with 'repos-ext' for external users). Log in with your NIH domain user name and password (remember to include NIH\ before your userid) or the user id and password provided to you by someone on the MIPAV team. Browse down the repository tree to trunk/mipav, right click the mipav folder, and perform a Checkout as a new project.
Hit next on the first page of the wizard. On the next page, give the project a name (mipav), and select "Create project from existing source" and browse to wherever you want the mipav source to be checked out to. Hit next and you'll most likely want to change the "Default output folder" to something like mipav/classes. Hit finish and a new working copy of the mipav source will be downloaded.
Select Project -> Properties from the menu. Select Java Build Path in the pane on the right.
In the Source tab, add the following folders: mipav/src, mipav/src/plugins, mipav/src/xml. Under mipav/src you want to exclude the following (Edit...): help/mipav_help.jar, InsightToolkit/lib/InsightToolkit/InsightToolkit.jar, and all of the jar files under the lib directory (this should speed up builds a little bit).
In the Libraries tab, use the Add JARs... button to add all of the jars under mipav/src/lib, mipav/src/help, and mipav/src/InsightToolkit. Make sure that the JVM being used is the one you want, if not add one through Add Library..., select the alternate JRE radio button and click Installed JREs. From there you can add the JRE/JDK that you want to use.
Next, go to the Java Compiler section of the right side of the project properties dialog and click the Configure Workspace Settings... link at the top. Set the Compiler compliance level, Generated .class files compatibility, and the Source compatibility to 5.0.
That should be all the basic setup you need to get mipav building. The Navigator view (Window -> Show view -> Navigator) allows you to refresh the files seen by Eclipse. It's a good idea to do this after doing a subversion update and it will initiate the compilation of any changed files. You can also perform subversion actions through right clicking on a folder and selecting something in the Team menu.
