imagingbook.lib.ij

Class IjUtils

java.lang.Object

imagingbook.lib.ij.IjUtils

public abstract class IjUtils
extends Object

Constructor Summary

Constructors

Constructor and Description
IjUtils()

Method Summary

Modifier and Type	Method and Description
static String	askForOpenPath(String title) Queries the user for an arbitrary file to be opened.
static ij.ImagePlus	createImage(String title, double[][] M) Creates an ImageJ ImagePlus image for the matrix M[r][c] (2D array), where r is treated as the row (vertical) coordinate and c is treated as the column (horizontal) coordinate.
static ij.ImagePlus	createImage(String title, float[][] M) Creates an ImageJ ImagePlus image for the matrix M[r][c] (2D array), where r is treated as the row (vertical) coordinate and c is treated as the column (horizontal) coordinate.
static String[]	getImageShortTitles(ij.ImagePlus[] images) Returns an array of strings containing the short titles of the images supplied.
static ij.ImagePlus[]	getOpenImages(boolean sortByTitle) Returns a (possibly empty) array of ImagePlus objects that are sorted by their titles if the 'sortByTitle' flag is set.
static ij.ImagePlus[]	getOpenImages(boolean sortByTitle, ij.ImagePlus exclude) Returns a (possibly empty) array of ImagePlus objects that are sorted by their titles if the sortByTitle flag is set.
static ij.ImagePlus	selectOpenImage(String title) Opens a dialog to let the user select one of the currently open images.
static void	setRgbConversionWeights(ij.process.ImageProcessor ip) Sets the weighing factors for the color components used in RGB-to-grayscale conversion for the specified image ip.
static void	setRgbConversionWeights(ij.process.ImageProcessor ip, double wr, double wg, double wb) Sets the weighing factors for the color components used in RGB-to-grayscale conversion for the specified image ip.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

IjUtils

public IjUtils()

Method Detail

getOpenImages

public static ij.ImagePlus[] getOpenImages(boolean sortByTitle)

Returns a (possibly empty) array of ImagePlus objects that are sorted by their titles if the 'sortByTitle' flag is set.

Parameters:

sortByTitle - flag, result is sorted if true.

Returns:

an array of currently open images.

getImageShortTitles

public static String[] getImageShortTitles(ij.ImagePlus[] images)

Returns an array of strings containing the short titles of the images supplied.

Parameters:

images - array of images.

Returns:

array of names.

selectOpenImage

public static ij.ImagePlus selectOpenImage(String title)

Opens a dialog to let the user select one of the currently open images.

Parameters:

title - string to show in the dialog

Returns:

An ImagePlus object, use the getProcessor method to obtain the associated ImageProcessor

getOpenImages

public static ij.ImagePlus[] getOpenImages(boolean sortByTitle,
                                           ij.ImagePlus exclude)

Returns a (possibly empty) array of ImagePlus objects that are sorted by their titles if the sortByTitle flag is set. The image "exclude" (typically the current image) is not included in the returned array (pass null to exclude no image).

Parameters:

sortByTitle - set true to return images sorted by title

exclude - reference to an image to be excluded (may be null)

Returns:

a (possibly empty) array of ImagePlus objects

askForOpenPath

public static String askForOpenPath(String title)

Queries the user for an arbitrary file to be opened.

Parameters:

title - string to be shown in the interaction window.

Returns:

path of the selected resource.

createImage

public static ij.ImagePlus createImage(String title,
                                       float[][] M)

Creates an ImageJ ImagePlus image for the matrix M[r][c] (2D array), where r is treated as the row (vertical) coordinate and c is treated as the column (horizontal) coordinate. Use show() to display the resulting image.

Parameters:

title - image title

M - 2D array

Returns:

a new ImagePlus image

createImage

public static ij.ImagePlus createImage(String title,
                                       double[][] M)

Creates an ImageJ ImagePlus image for the matrix M[r][c] (2D array), where r is treated as the row (vertical) coordinate and c is treated as the column (horizontal) coordinate. Use show() to display the resulting image.

Parameters:

title - the image title

M - a 2D array holding the image data

Returns:

a new ImagePlus instance

setRgbConversionWeights

public static void setRgbConversionWeights(ij.process.ImageProcessor ip)

Sets the weighing factors for the color components used in RGB-to-grayscale conversion for the specified image ip. Note that this method can be applied to any ImageProcessor instance but has no effect unless ip is of type ColorProcessor. Applies standard (ITU-709) weights.

Parameters:

ip - The affected image

setRgbConversionWeights

public static void setRgbConversionWeights(ij.process.ImageProcessor ip,
                                           double wr,
                                           double wg,
                                           double wb)

Sets the weighing factors for the color components used in RGB-to-grayscale conversion for the specified image ip. Note that this method can be applied to any ImageProcessor instance but has no effect unless ip is of type ColorProcessor.

Parameters:

ip - The affected image

wr - Red weight

wg - Green weight

wb - Blue weight