Buck9195/Asi_Native_FiJi_launcher
1
0
Fork 0
mirror of https://github.com/ij-plugins/ijp-imagej-launcher.git synced 2024-11-13 16:29:01 -08:00
Code Issues Projects Releases Packages Wiki Activity Actions
IJP ImageJ Launcher is native launcher that starts ImageJ 2 or Fiji
7 commits 2 branches 2 tags 316 KiB
Find a file
Jarek Sacha 30d41e3a40
Make logger immutable
2023-05-20 17:24:34 -04:00
project Add parsing of command line options 2023-05-15 15:07:40 -04:00
src/main Make logger immutable 2023-05-20 17:24:34 -04:00
.gitignore Import an initial version created by sbt new scala-native/scala-native.g8 2023-05-15 10:55:06 -04:00
.scalafmt.conf Determine total system memory 2023-05-19 22:16:57 -04:00
build.sbt Determine total system memory 2023-05-19 22:16:57 -04:00
LICENSE.txt Add license file 2023-05-19 19:09:16 -04:00
ReadMe.md Add description of the project 2023-05-19 22:21:45 -04:00

ReadMe.md

IJP ImageJ Launcher

IJP ImageJ Launcher is native launcher that starts ImageJ 2 or Fiji. It is intended to be a general drop-in replacement for the original ImageJ Launcher. IJP ImageJ Launcher is a clean implementation on the core function of starting ImageJ 2 or Fiji.

Why Another ImageJ Launcher

I needed to use Fji with the current versions of Java, version 11 and newer. The original ImageJ Launcher works with Java 8, but not that well with the current versions, in particular not well on Mac with Arm64 processors (Apple Silicon). I attempted to fix the original ImageJ Launcher source. The source is burdened by technical debt, the logic flow is too complex to correct without a significant rewrite.

Features [work in progress]

  • Uses similar options to the original ImageJ Launcher, si IJP Launcher can be drop-in replacement
  • Provides native executable for various OS/Hardware systems
    • Windows
    • Mac OS X Arm64 (Apple Silicon)
    • Mac OS X Intel
    • Linux
  • Selects location of ImageJ directory
    • Startup directory or
    • Directory specified by --ij-dir command line option
  • Locates Java Virtual Machine for ImageJ:
    • Use Java VM requested the by the use (--java-home)
    • Use JAVA_HOME environment variable
    • Search ImageJ directory for available Java executables
  • Determines the amount of memory used by JVM based on total system memory use 75% of the max
  • Determines available imagej-launcher*.jar
  • Performs updates pending after last time ImageJ was closed

Full list of command line options

  -h, --help          prints this usage text
  --version           prints version
  --dry-run           show the command line, but do not run anything
  --info              informational output
  --debug             verbose output
  --java-home <path>  specify JAVA_HOME explicitly
  --print-java-home   print ImageJ's idea of JAVA_HOME
  --ij-dir <path>     set the ImageJ directory to <path> (used to find jars/, plugins/ and macros/)

Installation

The IJP ImageJ Launcher executables will be available on the [Releases] page.