ij-plugins / ijp-color

Plugins for ImageJ - color space conversions and color calibration

Version Matrix

ijp-color

Operations on color spaces and color images. Can be used as a stand-alone library or a plugin for ImageJ

Actions Status Maven Central Scaladoc

ImageJ Plugins

IJP Color Calibrator

Color calibrates images using a color chart. Supported charts:

  • GretagMacbeth ColorChecker
  • X-Rite Passport
  • Image Science Associates ColorGauge
  • Custom charts - provide your own layout and CIE L*a*b* color values

Supports 8, 16, 32 bit per channel color images, including raw.

Image Calibrator

More details in project Wiki

IJP Color Calculator

Tool for converting individual color values between different color spaces. Inspired by Bruce Lindbloom CIE Color Calculator

Image Calibrator

IJP Color Chart ROI Tool

Converts color chart ROI to individual chip ROIs. Measures color of each chip.

Chart Tool

Test Images

You can test the calibrator plugin using images in test/data.

Installing Plugins in ImageJ

ImageJ

Option 1

Prebuild binaries are published with each Release.

  1. Look for in the asset section for an "ijp-color_plugins_*_win.zip" file,
  2. download and unzip into ImageJ's plugins directory. It should create subdirectory "ij-plugins".
  3. Restart ImageJ

Option 2

IJP Color is also a part of the ij-plugins-bundle. You can download from its Release page.

ImageJ2/FIJI

IJP Color is a part of the ij-plugins-bundle that is also distributed for FIJI/ImageJ2 as IJ-Plugins Update Site: "https://sites.imagej.net/IJ-Plugins/"

Stand-alone Library

ijp-color was designed to be easily used as a stand-alone library. Examples of use are provided in the ijp-color/test directory.

Development Setup

The minimum requirement to build an run the plugin in development environment is Java and SBT. SBT will download all needed dependencies. Key libraries: ImageJ, Scala, and ScalaFX.

Command line

You can build the ij-color plugins and run it within ImageJ using SBT task ijRun from the experimental module:

sbt ijRun

IntelliJ

You will need to install Scala plugin then import the project from build.sbt file. To run the ij-color plugins in ImageJ, setup "Run Configuration" for "SBT Task" and add task experimental/ijRun.