Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Submit feedback
Contribute to GitLab
Sign in
Toggle navigation
I
imagej-elphel
Project
Project
Details
Activity
Releases
Cycle Analytics
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Charts
Issues
3
Issues
3
List
Board
Labels
Milestones
Wiki
Wiki
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Charts
Create a new issue
Commits
Issue Boards
Open sidebar
Elphel
imagej-elphel
Commits
37ef16f3
Commit
37ef16f3
authored
Apr 13, 2014
by
Andrey Filippov
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
customized readme
parent
4665aba0
Changes
1
Show whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
4 additions
and
74 deletions
+4
-74
README.md
README.md
+4
-74
No files found.
README.md
View file @
37ef16f3
This is a minimal Maven project implementing an ImageJ 1.x plugin
This is a set of Elphel plugins for ImageJ 1.x as a Maven project with specified
dependencies,
It is intended as an ideal starting point to develop new ImageJ 1.x plugins
If cloned and imported as existent Maven project into Eclipse IDE, it allows to launch
in an IDE of your choice. You can even collaborate with developers using a
ImageJ with plugins in both run and debug modes.
different IDE than you.
In
[
Eclipse
](
http://eclipse.org
)
, for example, it is as simple as
_File>Import...>Existing Maven Project_
In
[
Netbeans
](
http://netbeans.org
)
, it is even simpler: _File
>
Open_
Project. The same works in
[
IntelliJ
](
http://jetbrains.net
)
.
If
[
jEdit
](
http://jedit.org
)
is your preferred IDE, you will need the
[
Maven
Plugin](http://plugins.jedit.org/plugins/?MavenPlugin).
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
](
fiji.sc/Debugging#Debugging_plugins_in_an_IDE_.28Netbeans.2C_IntelliJ.2C_Eclipse.2C_etc.29
)
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
*
```git clone git://github.com/imagej/minimal-ij1-plugin```
, or
*
unpack https://github.com/imagej/minimal-ij1-plugin/archive/master.zip
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
](
http://fiji.sc/Maven#How_to_find_a_dependency.27s_groupId.2FartifactId.2Fversion_.28GAV.29.3F
)
)
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```
4.
Replace the contents of
```README.md```
with information about 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
](
https://github.com/new
)
5.
```git remote set-url origin git@github.com:<username>/<projectname>```
6.
```git push origin HEAD```
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment