Package com.twelvemonkeys.image

Class InverseColorMapIndexColorModel

java.lang.Object

java.awt.image.ColorModel

java.awt.image.IndexColorModel

com.twelvemonkeys.image.InverseColorMapIndexColorModel

All Implemented Interfaces:

java.awt.Transparency

public class InverseColorMapIndexColorModel
extends java.awt.image.IndexColorModel

A faster implementation of IndexColorModel, that is backed by an inverse color-map, for fast look-ups.

Version:

$Id: //depot/branches/personal/haraldk/twelvemonkeys/release-2/twelvemonkeys-core/src/main/java/com/twelvemonkeys/image/InverseColorMapIndexColorModel.java#1 $

Field Summary

Fields

Modifier and Type	Field	Description
private static int	ALPHA_THRESHOLD
protected InverseColorMap	inverseMap
protected int	mapSize
private static int	RGB_MASK
protected int[]	rgbs
private static int	WHITE
private int	whiteIndex

Fields inherited from class java.awt.image.ColorModel

pixel_bits, transferType

Fields inherited from interface java.awt.Transparency

BITMASK, OPAQUE, TRANSLUCENT

Constructor Summary

Constructors

Modifier	Constructor	Description
	InverseColorMapIndexColorModel(int pNumBits, int pSize, byte[] pReds, byte[] pGreens, byte[] pBlues)	Creates an InverseColorMapIndexColorModel from the given arrays of red, green, and blue components.
	InverseColorMapIndexColorModel(int pNumBits, int pSize, byte[] pReds, byte[] pGreens, byte[] pBlues, int pTransparentIndex)	Creates an InverseColorMapIndexColorModel from the given arrays of red, green, and blue components, plus one transparent index.
	InverseColorMapIndexColorModel(int pNumBits, int pSize, int[] pRGBs, int pStart, boolean pAlpha, int pTransparentIndex, int pTransferType)	Creates an InverseColorMapIndexColorModel from the given array of RGB components, plus one transparent index.
	InverseColorMapIndexColorModel(java.awt.image.IndexColorModel pColorModel)	Creates an InverseColorMapIndexColorModel from an existing IndexColorModel.
private	InverseColorMapIndexColorModel(java.awt.image.IndexColorModel pColorModel, int[] pRGBs)

Method Summary

Modifier and Type	Method	Description
static java.awt.image.IndexColorModel	create(java.awt.Image pImage, int pNumCols, int pFlags)	Creates an IndexColorModel optimized for the given Image.
java.lang.Object	getDataElements(int rgb, java.lang.Object pixel)	Returns a data element array representation of a pixel in this ColorModel, given an integer pixel representation in the default RGB color model.
private static int[]	getRGBs(java.awt.image.IndexColorModel pColorModel)	Creates a defensive copy of the RGB color map in the given IndexColorModel.
private int	getWhiteIndex()
private java.lang.Object	installpixel(java.lang.Object pixel, int pix)
java.lang.String	toString()

Methods inherited from class java.awt.image.IndexColorModel

convertToIntDiscrete, createCompatibleSampleModel, createCompatibleWritableRaster, equals, finalize, getAlpha, getAlphas, getBlue, getBlues, getComponents, getComponents, getComponentSize, getDataElement, getDataElements, getGreen, getGreens, getMapSize, getRed, getReds, getRGB, getRGBs, getTransparency, getTransparentPixel, getValidPixels, hashCode, isCompatibleRaster, isCompatibleSampleModel, isValid, isValid

Methods inherited from class java.awt.image.ColorModel

coerceData, getAlpha, getAlphaRaster, getBlue, getColorSpace, getComponentSize, getDataElement, getDataElements, getGreen, getNormalizedComponents, getNormalizedComponents, getNumColorComponents, getNumComponents, getPixelSize, getRed, getRGB, getRGBdefault, getTransferType, getUnnormalizedComponents, hasAlpha, isAlphaPremultiplied

Methods inherited from class java.lang.Object

clone, getClass, notify, notifyAll, wait, wait, wait

Field Detail

rgbs

protected int[] rgbs

mapSize

protected int mapSize

inverseMap

protected InverseColorMap inverseMap

ALPHA_THRESHOLD

private static final int ALPHA_THRESHOLD

See Also:

Constant Field Values

whiteIndex

private int whiteIndex

WHITE

private static final int WHITE

See Also:

Constant Field Values

RGB_MASK

private static final int RGB_MASK

See Also:

Constant Field Values

Constructor Detail

InverseColorMapIndexColorModel

public InverseColorMapIndexColorModel(java.awt.image.IndexColorModel pColorModel)

Creates an InverseColorMapIndexColorModel from an existing IndexColorModel.

Parameters:

pColorModel - the color model to create from.

Throws:

java.lang.IllegalArgumentException - if pColorModel is null

InverseColorMapIndexColorModel

private InverseColorMapIndexColorModel(java.awt.image.IndexColorModel pColorModel,
                                       int[] pRGBs)

InverseColorMapIndexColorModel

public InverseColorMapIndexColorModel(int pNumBits,
                                      int pSize,
                                      int[] pRGBs,
                                      int pStart,
                                      boolean pAlpha,
                                      int pTransparentIndex,
                                      int pTransferType)

Creates an InverseColorMapIndexColorModel from the given array of RGB components, plus one transparent index.

Parameters:

pNumBits - the number of bits each pixel occupies

pSize - the size of the color component arrays

pRGBs - the array of packed RGB color components

pStart - the starting offset of the first color component

pAlpha - indicates whether alpha values are contained in pRGBs

pTransparentIndex - the index of the transparent pixel

pTransferType - the data type of the array used to represent pixels

Throws:

java.lang.IllegalArgumentException - if bits is less than 1 or greater than 16, or if size is less than 1

See Also:

IndexColorModel(int, int, int[], int, boolean, int, int)

InverseColorMapIndexColorModel

public InverseColorMapIndexColorModel(int pNumBits,
                                      int pSize,
                                      byte[] pReds,
                                      byte[] pGreens,
                                      byte[] pBlues,
                                      int pTransparentIndex)

Creates an InverseColorMapIndexColorModel from the given arrays of red, green, and blue components, plus one transparent index.

Parameters:

pNumBits - the number of bits each pixel occupies

pSize - the size of the color component arrays

pReds - the array of red color components

pGreens - the array of green color components

pBlues - the array of blue color components

pTransparentIndex - the index of the transparent pixel

Throws:

java.lang.IllegalArgumentException - if bits is less than 1 or greater than 16, or if size is less than 1

See Also:

IndexColorModel(int, int, byte[], byte[], byte[], int)

InverseColorMapIndexColorModel

public InverseColorMapIndexColorModel(int pNumBits,
                                      int pSize,
                                      byte[] pReds,
                                      byte[] pGreens,
                                      byte[] pBlues)

Creates an InverseColorMapIndexColorModel from the given arrays of red, green, and blue components.

Parameters:

pNumBits - the number of bits each pixel occupies

pSize - the size of the color component arrays

pReds - the array of red color components

pGreens - the array of green color components

pBlues - the array of blue color components

Throws:

java.lang.IllegalArgumentException - if bits is less than 1 or greater than 16, or if size is less than 1

See Also:

IndexColorModel(int, int, byte[], byte[], byte[])

Method Detail

getRGBs

private static int[] getRGBs(java.awt.image.IndexColorModel pColorModel)

Creates a defensive copy of the RGB color map in the given IndexColorModel.

Parameters:

pColorModel - the indexed color model to get RGB values from

Returns:

the RGB color map

getWhiteIndex

private int getWhiteIndex()

create

public static java.awt.image.IndexColorModel create(java.awt.Image pImage,
                                                    int pNumCols,
                                                    int pFlags)

Creates an IndexColorModel optimized for the given Image.

Parameters:

pImage - the Image containing the RGB samples

pNumCols - the maximum number of colors in the IndexColorModel

pFlags - flags

Returns:

a new optimized IndexColorModel

getDataElements

public java.lang.Object getDataElements(int rgb,
                                        java.lang.Object pixel)

Returns a data element array representation of a pixel in this ColorModel, given an integer pixel representation in the default RGB color model. This array can then be passed to the setDataElements method of a WritableRaster object. If the pixel variable is null, a new array is allocated. If pixel is not null, it must be a primitive array of type transferType; otherwise, a ClassCastException is thrown. An ArrayIndexOutOfBoundsException is thrown if pixel is not large enough to hold a pixel value for this ColorModel. The pixel array is returned.

Since OpaqueIndexColorModel can be subclassed, subclasses inherit the implementation of this method and if they don't override it then they throw an exception if they use an unsupported transferType. #param rgb the integer pixel representation in the default RGB color model #param pixel the specified pixel #return an array representation of the specified pixel in this OpaqueIndexColorModel. #throws ClassCastException if pixel is not a primitive array of type transferType #throws ArrayIndexOutOfBoundsException if pixel is not large enough to hold a pixel value for this ColorModel #throws UnsupportedOperationException if transferType is invalid

Overrides:

getDataElements in class java.awt.image.IndexColorModel

See Also:

WritableRaster.setDataElements(int, int, java.lang.Object), SampleModel.setDataElements(int, int, java.lang.Object, java.awt.image.DataBuffer)

installpixel

private java.lang.Object installpixel(java.lang.Object pixel,
                                      int pix)

toString

public java.lang.String toString()

Overrides:

toString in class java.awt.image.IndexColorModel