ij.process
Class ColorProcessor

java.lang.Object
  ij.process.ImageProcessor
      ij.process.ColorProcessor

public class ColorProcessor
extends ImageProcessor

This is an 32-bit RGB image and methods that operate on that image.. Based on the ImageProcessor class from "KickAss Java Programming" by Tonny Espeset (http://www.sn.no/~espeset).

Field Summary

protected int[]	pixels
int	RGB_DILATE
int	RGB_ERODE
int	RGB_FIND_EDGES
int	RGB_MEDIAN
int	RGB_NOISE
int	RGB_THRESHOLD
protected int[]	snapshotPixels

Fields inherited from class ij.process.ImageProcessor

baseCM, BLACK, BLACK_AND_WHITE_LUT, bLUT1, bLUT2, cm, cTable, cx, cy, font, fontMetrics, gLUT1, gLUT2, height, histogramSize, imageSource, interpolate, inversionTested, invertedLut, lineWidth, lutAnimation, maxThreshold, minThreshold, NO_LUT_UPDATE, NO_THRESHOLD, RED_LUT, rLUT1, rLUT2, roiHeight, roiWidth, roiX, roiY, snapshotHeight, snapshotWidth, width, xMax, xMin, yMax, yMin

Constructor Summary

ColorProcessor(java.awt.Image img)
Creates a ColorProcessor from an AWT Image.

ColorProcessor(int width, int height)
Creates a blank ColorProcessor of the specified dimensions.

ColorProcessor(int width, int height, int[] pixels)
Creates a ColorProcessor from a pixel array.

Method Summary

void	applyTable(int[] lut) Transforms the image or ROI using a lookup table.
void	autoThreshold() For byte images, converts to binary using an automatically determined threshold.
void	convolve3x3(int[] kernel) 3x3 convolution contributed by Glynne Casteel.
void	copyBits(ImageProcessor ip, int xloc, int yloc, int mode) Copies the image contained in 'ip' to (xloc, yloc) using one of the transfer modes defined in the Blitter interface.
java.awt.Image	createImage() Returns a copy of this image is the form of an AWT Image.
ImageProcessor	createProcessor(int width, int height) Returns a new, blank ShortProcessor with the specified width and height.
ImageProcessor	crop() Creates a new processor containing an image that corresponds to the current ROI.
void	dilate() Dilates the image or ROI using a 3x3 minimum filter.
void	drawPixel(int x, int y) Draws a pixel in the current foreground color.
void	erode() Erodes the image or ROI using a 3x3 maximum filter.
void	fill() Fills the current rectangular ROI.
void	fill(int[] mask) Fills pixels that are within roi and part of the mask.
void	filter(int type) 3x3 unweighted smoothing.
void	filterRGB(int type, double arg) Performs the specified 3x3 filter on the reg, green and blue planes.
void	findEdges() Finds edges in the image or ROI using a Sobel operator.
int	getBestIndex(java.awt.Color c) Always returns 0 since RGB images do not use LUTs.
java.awt.Color	getColor(int x, int y)
int[]	getHistogram() Returns the histogram of the image or ROI.
int[]	getHistogram(int[] mask)
void	getHSB(byte[] H, byte[] S, byte[] B) Returns hue, saturation and brightness in 3 byte arrays.
double	getInterpolatedPixel(double x, double y) Calls getPixelValue(x,y).
double	getMax() Returns the largest displayed pixel value.
double	getMin() Returns the smallest displayed pixel value.
int	getPixel(int x, int y) Returns the value of the pixel at (x,y).
java.lang.Object	getPixels() Returns a reference to the int array containing this image's pixel data.
java.lang.Object	getPixelsCopy() Returns a reference to this image's snapshot (undo) array.
float	getPixelValue(int x, int y) Converts the specified pixel to grayscale (g=r*0.30+g*0.59+b*0.11) and returns it as a float.
void	getRGB(byte[] R, byte[] G, byte[] B) Returns the red, green and blue planes as 3 byte arrays.
void	invertLut() Does nothing since RGB images do not use LUTs.
boolean	isInvertedLut() Always returns false since RGB images do not use LUTs.
void	medianFilter() A 3x3 median filter.
void	noise(double range) Adds random noise to the image or ROI.
void	putPixel(int x, int y, int value) Stores the specified value at (x,y).
void	putPixelValue(int x, int y, double value) Stores the specified real value at (x,y).
void	reset() Restores the pixel data from the snapshot (undo) buffer.
void	reset(int[] mask) Restore pixels that are within roi but not part of the mask.
ImageProcessor	resize(int dstWidth, int dstHeight) Creates a new ColorProcessor containing a scaled copy of this image or selection.
void	rotate(double angle) Rotates the image or ROI 'angle' degrees clockwise.
void	scale(double xScale, double yScale) Scales the image or selection using the specified scale factors.
void	setColor(java.awt.Color color) Sets the foreground color.
void	setHSB(byte[] H, byte[] S, byte[] B) Sets the current pixels from 3 byte arrays (hue, saturation and brightness).
void	setMinAndMax(double min, double max) Uses a table look-up to map the pixels in this image from min-max to 0-255.
void	setPixels(java.lang.Object pixels) Sets a new pixel array for the image and resets the snapshot buffer.
void	setRGB(byte[] R, byte[] G, byte[] B) Sets the current pixels from 3 byte arrays (reg, green, blue).
void	setValue(double value) Sets the default fill/draw value, where value is interpreted as an RGB int.
void	snapshot() Makes a copy of this image's pixel data.

Methods inherited from class ij.process.ImageProcessor

add, and, convertToByte, convertToFloat, convertToRGB, convertToShort, drawDot, drawDot2, drawString, duplicate, flipHorizontal, flipVertical, gamma, getColorModel, getColumn, getHeight, getHistogramSize, getImageSource, getLine, getMask, getMaxThreshold, getMinThreshold, getRoi, getRow, getStringWidth, getWidth, hideProgress, insert, invert, isKillable, lineTo, log, makeDefaultColorModel, moveTo, multiply, or, putColumn, putRow, resetMinAndMax, rotateLeft, rotateRight, setCalibrationTable, setColor, setColorModel, setFont, setHistogramSize, setInterpolate, setLineWidth, setLutAnimation, setMask, setProgressBar, setRoi, setRoi, setThreshold, sharpen, showProgress, smooth, toString, xor

Methods inherited from class java.lang.Object

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

Field Detail

pixels

protected int[] pixels

snapshotPixels

protected int[] snapshotPixels

RGB_NOISE

public final int RGB_NOISE

See Also:

Constant Field Values

RGB_MEDIAN

public final int RGB_MEDIAN

See Also:

Constant Field Values

RGB_FIND_EDGES

public final int RGB_FIND_EDGES

See Also:

Constant Field Values

RGB_ERODE

public final int RGB_ERODE

See Also:

Constant Field Values

RGB_DILATE

public final int RGB_DILATE

See Also:

Constant Field Values

RGB_THRESHOLD

public final int RGB_THRESHOLD

See Also:

Constant Field Values

Constructor Detail

ColorProcessor

public ColorProcessor(java.awt.Image img)

Creates a ColorProcessor from an AWT Image.

ColorProcessor

public ColorProcessor(int width,
                      int height)

Creates a blank ColorProcessor of the specified dimensions.

ColorProcessor

public ColorProcessor(int width,
                      int height,
                      int[] pixels)

Creates a ColorProcessor from a pixel array.

Method Detail

createImage

public java.awt.Image createImage()

Description copied from class: ImageProcessor

Returns a copy of this image is the form of an AWT Image.

Specified by:

createImage in class ImageProcessor

createProcessor

public ImageProcessor createProcessor(int width,
                                      int height)

Returns a new, blank ShortProcessor with the specified width and height.

Specified by:

createProcessor in class ImageProcessor

getColor

public java.awt.Color getColor(int x,
                               int y)

setColor

public void setColor(java.awt.Color color)

Sets the foreground color.

Specified by:

setColor in class ImageProcessor

setValue

public void setValue(double value)

Sets the default fill/draw value, where value is interpreted as an RGB int.

Specified by:

setValue in class ImageProcessor

getMin

public double getMin()

Returns the smallest displayed pixel value.

Specified by:

getMin in class ImageProcessor

getMax

public double getMax()

Returns the largest displayed pixel value.

Specified by:

getMax in class ImageProcessor

setMinAndMax

public void setMinAndMax(double min,
                         double max)

Uses a table look-up to map the pixels in this image from min-max to 0-255.

Specified by:

setMinAndMax in class ImageProcessor

snapshot

public void snapshot()

Description copied from class: ImageProcessor

Makes a copy of this image's pixel data.

Specified by:

snapshot in class ImageProcessor

reset

public void reset()

Description copied from class: ImageProcessor

Restores the pixel data from the snapshot (undo) buffer.

Specified by:

reset in class ImageProcessor

reset

public void reset(int[] mask)

Description copied from class: ImageProcessor

Restore pixels that are within roi but not part of the mask.

Specified by:

reset in class ImageProcessor

fill

public void fill(int[] mask)

Fills pixels that are within roi and part of the mask.

Specified by:

fill in class ImageProcessor

getPixelsCopy

public java.lang.Object getPixelsCopy()

Description copied from class: ImageProcessor

Returns a reference to this image's snapshot (undo) array. If the snapshot array is null, returns a copy of the pixel data. The array type varies depending on the image type.

Specified by:

getPixelsCopy in class ImageProcessor

getPixel

public int getPixel(int x,
                    int y)

Description copied from class: ImageProcessor

Returns the value of the pixel at (x,y). For RGB images, the argb values are packed in an int. For float images, the the value must be converted using Float.intBitsToFloat().

Specified by:

getPixel in class ImageProcessor

getInterpolatedPixel

public double getInterpolatedPixel(double x,
                                   double y)

Calls getPixelValue(x,y).

Specified by:

getInterpolatedPixel in class ImageProcessor

putPixel

public void putPixel(int x,
                     int y,
                     int value)

Stores the specified value at (x,y).

Specified by:

putPixel in class ImageProcessor

putPixelValue

public void putPixelValue(int x,
                          int y,
                          double value)

Stores the specified real value at (x,y).

Specified by:

putPixelValue in class ImageProcessor

getPixelValue

public float getPixelValue(int x,
                           int y)

Converts the specified pixel to grayscale (g=r*0.30+g*0.59+b*0.11) and returns it as a float.

Specified by:

getPixelValue in class ImageProcessor

drawPixel

public void drawPixel(int x,
                      int y)

Draws a pixel in the current foreground color.

Specified by:

drawPixel in class ImageProcessor

getPixels

public java.lang.Object getPixels()

Returns a reference to the int array containing this image's pixel data.

Specified by:

getPixels in class ImageProcessor

setPixels

public void setPixels(java.lang.Object pixels)

Description copied from class: ImageProcessor

Sets a new pixel array for the image and resets the snapshot buffer. The length of the array must be equal to width*height.

Specified by:

setPixels in class ImageProcessor

getHSB

public void getHSB(byte[] H,
                   byte[] S,
                   byte[] B)

Returns hue, saturation and brightness in 3 byte arrays.

getRGB

public void getRGB(byte[] R,
                   byte[] G,
                   byte[] B)

Returns the red, green and blue planes as 3 byte arrays.

setRGB

public void setRGB(byte[] R,
                   byte[] G,
                   byte[] B)

Sets the current pixels from 3 byte arrays (reg, green, blue).

setHSB

public void setHSB(byte[] H,
                   byte[] S,
                   byte[] B)

Sets the current pixels from 3 byte arrays (hue, saturation and brightness).

copyBits

public void copyBits(ImageProcessor ip,
                     int xloc,
                     int yloc,
                     int mode)

Copies the image contained in 'ip' to (xloc, yloc) using one of the transfer modes defined in the Blitter interface.

Specified by:

copyBits in class ImageProcessor

applyTable

public void applyTable(int[] lut)

Description copied from class: ImageProcessor

Transforms the image or ROI using a lookup table. The length of the table must be 256 for byte images and 65536 for short images. RGB and float images are not supported.

Specified by:

applyTable in class ImageProcessor

fill

public void fill()

Fills the current rectangular ROI.

Overrides:

fill in class ImageProcessor

filterRGB

public void filterRGB(int type,
                      double arg)

Performs the specified 3x3 filter on the reg, green and blue planes.

noise

public void noise(double range)

Description copied from class: ImageProcessor

Adds random noise to the image or ROI.

Specified by:

noise in class ImageProcessor

Parameters:

range - the range of random numbers

medianFilter

public void medianFilter()

Description copied from class: ImageProcessor

A 3x3 median filter.

Specified by:

medianFilter in class ImageProcessor

findEdges

public void findEdges()

Description copied from class: ImageProcessor

Finds edges in the image or ROI using a Sobel operator.

Overrides:

findEdges in class ImageProcessor

erode

public void erode()

Description copied from class: ImageProcessor

Erodes the image or ROI using a 3x3 maximum filter.

Specified by:

erode in class ImageProcessor

dilate

public void dilate()

Description copied from class: ImageProcessor

Dilates the image or ROI using a 3x3 minimum filter.

Specified by:

dilate in class ImageProcessor

autoThreshold

public void autoThreshold()

Description copied from class: ImageProcessor

For byte images, converts to binary using an automatically determined threshold. For RGB images, converts each channel to binary. For short and float images, does nothing.

Specified by:

autoThreshold in class ImageProcessor

scale

public void scale(double xScale,
                  double yScale)

Scales the image or selection using the specified scale factors.

Specified by:

scale in class ImageProcessor

See Also:

ImageProcessor.setInterpolate(boolean)

crop

public ImageProcessor crop()

Description copied from class: ImageProcessor

Creates a new processor containing an image that corresponds to the current ROI.

Specified by:

crop in class ImageProcessor

resize

public ImageProcessor resize(int dstWidth,
                             int dstHeight)

Creates a new ColorProcessor containing a scaled copy of this image or selection.

Specified by:

resize in class ImageProcessor

See Also:

ImageProcessor.setInterpolate(boolean)

rotate

public void rotate(double angle)

Rotates the image or ROI 'angle' degrees clockwise.

Specified by:

rotate in class ImageProcessor

See Also:

ImageProcessor.setInterpolate(boolean)

convolve3x3

public void convolve3x3(int[] kernel)

3x3 convolution contributed by Glynne Casteel.

Specified by:

convolve3x3 in class ImageProcessor

filter

public void filter(int type)

3x3 unweighted smoothing.

Specified by:

filter in class ImageProcessor

getHistogram

public int[] getHistogram()

Description copied from class: ImageProcessor

Returns the histogram of the image or ROI. Returns a luminosity histogram for RGB images and null for float images.

Specified by:

getHistogram in class ImageProcessor

getHistogram

public int[] getHistogram(int[] mask)

isInvertedLut

public boolean isInvertedLut()

Always returns false since RGB images do not use LUTs.

Overrides:

isInvertedLut in class ImageProcessor

getBestIndex

public int getBestIndex(java.awt.Color c)

Always returns 0 since RGB images do not use LUTs.

Overrides:

getBestIndex in class ImageProcessor

invertLut

public void invertLut()

Does nothing since RGB images do not use LUTs.

Overrides:

invertLut in class ImageProcessor