IndexColorModel JDK 1.6)

Methods

public ColorModel coerceData (WritableRaster raster, boolean isAlphaPremultiplied) [Inherited From ColorModel]

Forces the raster data to match the state specified in the isAlphaPremultiplied variable, assuming the data is currently correctly described by this ColorModel.

Forces the raster data to match the state specified in the
isAlphaPremultiplied variable, assuming the data is
currently correctly described by this ColorModel. It
may multiply or divide the color raster data by alpha, or do
nothing if the data is in the correct state. If the data needs to
be coerced, this method will also return an instance of this
ColorModel with the isAlphaPremultiplied
flag set appropriately. This method will throw a
UnsupportedOperationException if it is not supported
by this ColorModel.
Since ColorModel is an abstract class,
any instance is an instance of a subclass. Subclasses must
override this method since the implementation in this abstract
class throws an UnsupportedOperationException.
Returns: a ColorModel object that represents the coerced data.
Parameters:
- raster - the WritableRaster data
- isAlphaPremultiplied - true if the alpha is premultiplied; false otherwise

public BufferedImage convertToIntDiscrete (Raster raster, boolean forceARGB)

Returns a new BufferedImage of TYPE_INT_ARGB or
TYPE_INT_RGB that has a Raster with pixel data
computed by expanding the indices in the source Raster
using the color/alpha component arrays of this ColorModel.
Only the lower n bits of each index value in the source
Raster, as specified in the
class description above, are used to
compute the color/alpha values in the returned image.
If forceARGB is true, a TYPE_INT_ARGB image is
returned regardless of whether or not this ColorModel
has an alpha component array or a transparent pixel.
Returns: a BufferedImage created with the specified Raster
Parameters:
- raster - the specified Raster
- forceARGB - if true, the returned BufferedImage is TYPE_INT_ARGB; otherwise it is TYPE_INT_RGB
Throws:
- IllegalArgumentException - if the raster argument is not compatible with this IndexColorModel

public SampleModel createCompatibleSampleModel (int w, int h) [Overrides ColorModel]

Creates a SampleModel with the specified width and height that has a data layout compatible with this ColorModel.

Creates a SampleModel with the specified
width and height that has a data layout compatible with
this ColorModel.
Returns: a SampleModel object with the specified width and height.
Parameters:
- w - the width to apply to the new SampleModel
- h - the height to apply to the new SampleModel
Throws:
- IllegalArgumentException - if w or h is not greater than 0
See Also: SampleModel,

public WritableRaster createCompatibleWritableRaster (int w, int h) [Overrides ColorModel]

Creates a WritableRaster with the specified width and height that has a data layout (SampleModel) compatible with this ColorModel.

Creates a WritableRaster with the specified width and height that has a data layout (SampleModel) compatible with this ColorModel. This method only works for color models with 16 or fewer bits per pixel.

Since IndexColorModel can be subclassed, any subclass that supports greater than 16 bits per pixel must override this method.
Returns: a WritableRaster object with the specified width and height.
Parameters:
- w - the width to apply to the new WritableRaster
- h - the height to apply to the new WritableRaster
Throws:
- UnsupportedOperationException - if the number of bits in a pixel is greater than 16
See Also: WritableRaster, SampleModel,

public boolean equals (Object obj) [Inherited From ColorModel]

Tests if the specified Object is an instance of ColorModel and if it equals this ColorModel.

Tests if the specified Object is an instance of
ColorModel and if it equals this
ColorModel.
Returns: true if the specified Object is an instance of ColorModel and equals this ColorModel; false otherwise.
Parameters:
- obj - the Object to test for equality

public void finalize () [Overrides ColorModel]

Disposes of system resources associated with this ColorModel once this ColorModel is no longer referenced.

publicfinal int getAlpha (int pixel) [Specified in ColorModel]

Returns the alpha component for the specified pixel, scaled from 0 to 255.

public int getAlpha (Object inData) [Inherited From ColorModel]

Returns the alpha component for the specified pixel, scaled from 0 to 255.

Returns the alpha component for the specified pixel, scaled
from 0 to 255. The pixel value is specified by an array of data
elements of type transferType passed in as an object reference.
If inData is not a primitive array of type transferType, a
ClassCastException is thrown. An
ArrayIndexOutOfBoundsException is thrown if
inData is not large enough to hold a pixel value for
this ColorModel.
If this transferType is not supported, a
UnsupportedOperationException will be
thrown. Since
ColorModel is an abstract class, any instance
must be an instance of a subclass. Subclasses inherit the
implementation of this method and if they don't override it, this
method throws an exception if the subclass uses a
transferType other than
DataBuffer.TYPE_BYTE,
DataBuffer.TYPE_USHORT, or
DataBuffer.TYPE_INT.
Returns: the alpha component of the specified pixel, scaled from 0 to 255.
Parameters:
- inData - the specified pixel
Throws:
- ClassCastException - if inData is not a primitive array of type transferType
- ArrayIndexOutOfBoundsException - if inData is not large enough to hold a pixel value for this ColorModel
- UnsupportedOperationException - if this tranferType is not supported by this ColorModel

public WritableRaster getAlphaRaster (WritableRaster raster) [Inherited From ColorModel]

Returns a Raster representing the alpha channel of an
image, extracted from the input Raster, provided that
pixel values of this ColorModel represent color and
alpha information as separate spatial bands (e.g.
ComponentColorModel and DirectColorModel).
This method assumes that Raster objects associated
with such a ColorModel store the alpha band, if
present, as the last band of image data. Returns null
if there is no separate spatial alpha channel associated with this
ColorModel. If this is an
IndexColorModel which has alpha in the lookup table,
this method will return null since
there is no spatially discrete alpha channel.
This method will create a new Raster (but will share
the data array).
Since ColorModel is an abstract class, any instance
is an instance of a subclass. Subclasses must override this
method to get any behavior other than returning null
because the implementation in this abstract class returns
null.
Returns: a Raster representing the alpha channel of an image, obtained from the specified Raster.
Parameters:
- raster - the specified Raster

publicfinal void getAlphas (byte[] a)

Copies the array of alpha transparency components into the specified array.

Copies the array of alpha transparency components into the
specified array. Only the initial entries of the array as specified
by getMapSize are written.
Parameters:
- a - the specified array into which the elements of the array of alpha components are copied

publicfinal int getBlue (int pixel) [Specified in ColorModel]

Returns the blue color component for the specified pixel, scaled from 0 to 255 in the default RGB ColorSpace, sRGB.

public int getBlue (Object inData) [Inherited From ColorModel]

Returns the blue color component for the specified pixel, scaled from 0 to 255 in the default RGB ColorSpace, sRGB.

Returns the blue color component for the specified pixel, scaled
from 0 to 255 in the default RGB ColorSpace, sRGB. A
color conversion is done if necessary. The pixel value is
specified by an array of data elements of type transferType passed
in as an object reference. The returned value is a non
pre-multiplied value. For example, if the alpha is premultiplied,
this method divides it out before returning the value. If the
alpha value is 0, the blue value will be 0. If
inData is not a primitive array of type transferType,
a ClassCastException is thrown. An
ArrayIndexOutOfBoundsException is
thrown if inData is not large enough to hold a pixel
value for this ColorModel.
If this transferType is not supported, a
UnsupportedOperationException will be
thrown. Since
ColorModel is an abstract class, any instance
must be an instance of a subclass. Subclasses inherit the
implementation of this method and if they don't override it, this
method throws an exception if the subclass uses a
transferType other than
DataBuffer.TYPE_BYTE,
DataBuffer.TYPE_USHORT, or
DataBuffer.TYPE_INT.
Returns: the value of the blue component of the specified pixel.
Parameters:
- inData - an array of pixel values
Throws:
- ClassCastException - if inData is not a primitive array of type transferType
- ArrayIndexOutOfBoundsException - if inData is not large enough to hold a pixel value for this ColorModel
- UnsupportedOperationException - if this tranferType is not supported by this ColorModel

publicfinal void getBlues (byte[] b)

Copies the array of blue color components into the specified array.

Copies the array of blue color components into the specified array.
Only the initial entries of the array as specified by
getMapSize are written.
Parameters:
- b - the specified array into which the elements of the array of blue color components are copied

publicfinal ColorSpace getColorSpace () [Inherited From ColorModel]

Returns the ColorSpace associated with this ColorModel.

Returns the ColorSpace associated with this
ColorModel.
Returns: the ColorSpace of this ColorModel.

public int getComponents (int pixel, int[] components, int offset) [Overrides ColorModel]

Returns an array of unnormalized color/alpha components for a specified pixel in this ColorModel.

Returns an array of unnormalized color/alpha components for a
specified pixel in this ColorModel. The pixel value
is specified as an int. If the components array is null,
a new array is allocated that contains
offset + getNumComponents() elements.
The components array is returned,
with the alpha component included
only if hasAlpha returns true.
Color/alpha components are stored in the components array starting
at offset even if the array is allocated by this method.
An ArrayIndexOutOfBoundsException
is thrown if the components array is not null and is
not large enough to hold all the color and alpha components
starting at offset.
Returns: an array containing the color and alpha components of the specified pixel starting at the specified offset.
Parameters:
- pixel - the specified pixel
- components - the array to receive the color and alpha components of the specified pixel
- offset - the offset into the components array at which to start storing the color and alpha components
See Also: ColorModel.hasAlpha(), ColorModel.getNumComponents(),

public int getComponents (Object pixel, int[] components, int offset) [Overrides ColorModel]

Returns an array of unnormalized color/alpha components for a specified pixel in this ColorModel.

Returns an array of unnormalized color/alpha components for a specified pixel in this ColorModel. The pixel value is specified by an array of data elements of type transferType passed in as an object reference. If pixel is not a primitive array of type transferType, a ClassCastException is thrown. An ArrayIndexOutOfBoundsException is thrown if pixel is not large enough to hold a pixel value for this ColorModel. If the components array is null, a new array is allocated that contains offset + getNumComponents() elements. The components array is returned, with the alpha component included only if hasAlpha returns true. Color/alpha components are stored in the components array starting at offset even if the array is allocated by this method. An ArrayIndexOutOfBoundsException is also thrown if the components array is not null and is not large enough to hold all the color and alpha components starting at offset.

Since IndexColorModel 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.
Returns: an array containing the color and alpha components of the specified pixel starting at the specified offset.
Parameters:
- pixel - the specified pixel
- components - an array that receives the color and alpha components of the specified pixel
- offset - the index into the components array at which to begin storing the color and alpha components of the specified pixel
Throws:
- ArrayIndexOutOfBoundsException - if pixel is not large enough to hold a pixel value for this ColorModel or if the components array is not null and is not large enough to hold all the color and alpha components starting at offset
- ClassCastException - if pixel is not a primitive array of type transferType
- UnsupportedOperationException - if transferType is not one of the supported transer types
See Also: ColorModel.hasAlpha(), ColorModel.getNumComponents(),

public int getComponentSize () [Overrides ColorModel]

Returns an array of the number of bits for each color/alpha component.

Returns an array of the number of bits for each color/alpha component.
The array contains the color components in the order red, green,
blue, followed by the alpha component, if present.
Returns: an array containing the number of bits of each color and alpha component of this IndexColorModel

public int getComponentSize (int componentIdx) [Inherited From ColorModel]

Returns the number of bits for the specified color/alpha component.

Returns the number of bits for the specified color/alpha component.
Color components are indexed in the order specified by the
ColorSpace. Typically, this order reflects the name
of the color space type. For example, for TYPE_RGB, index 0
corresponds to red, index 1 to green, and index 2
to blue. If this ColorModel supports alpha, the alpha
component corresponds to the index following the last color
component.
Returns: the number of bits for the color/alpha component at the specified index.
Parameters:
- componentIdx - the index of the color/alpha component
Throws:
- ArrayIndexOutOfBoundsException - if componentIdx is greater than the number of components or less than zero
- NullPointerException - if the number of bits array is null

public int getDataElement (float[] normComponents, int normOffset) [Inherited From ColorModel]

Returns a pixel value represented as an int in this ColorModel, given an array of normalized color/alpha components.

Returns a pixel value represented as an int in this
ColorModel, given an array of normalized color/alpha
components. This method will throw an
IllegalArgumentException if pixel values for this
ColorModel are not conveniently representable as a
single int. An
ArrayIndexOutOfBoundsException is thrown if the
normComponents array is not large enough to hold all the
color and alpha components (starting at normOffset).
Since ColorModel is an abstract class,
any instance is an instance of a subclass. The default implementation
of this method in this abstract class first converts from the
normalized form to the unnormalized form and then calls
getDataElement(int[], int). Subclasses which may
have instances which do not support the unnormalized form must
override this method.
Returns: an int pixel value in this ColorModel corresponding to the specified components.
Parameters:
- normComponents - an array of normalized color and alpha components
- normOffset - the index into normComponents at which to begin retrieving the color and alpha components
Throws:
- IllegalArgumentException - if pixel values for this ColorModel are not conveniently representable as a single int
- ArrayIndexOutOfBoundsException - if the normComponents array is not large enough to hold all of the color and alpha components starting at normOffset
Since: 1.4

public int getDataElement (int[] components, int offset) [Overrides ColorModel]

Returns a pixel value represented as an int in this ColorModel given an array of unnormalized color/alpha components.

Returns a pixel value represented as an int in this
ColorModel given an array of unnormalized
color/alpha components. An
ArrayIndexOutOfBoundsException
is thrown if the components array is not large
enough to hold all of the color and alpha components starting
at offset. Since
ColorModel 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.
Returns: an int pixel value in this ColorModel corresponding to the specified components.
Parameters:
- components - an array of unnormalized color and alpha components
- offset - the index into components at which to begin retrieving the color and alpha components
Throws:
- ArrayIndexOutOfBoundsException - if the components array is not large enough to hold all of the color and alpha components starting at offset
- UnsupportedOperationException - if transferType is invalid

public Object getDataElements (float[] normComponents, int normOffset, Object obj) [Inherited From ColorModel]

Returns a data element array representation of a pixel in this ColorModel, given an array of normalized color/alpha components.

Returns a data element array representation of a pixel in this
ColorModel, given an array of normalized color/alpha
components. This array can then be passed to the
setDataElements method of a WritableRaster
object. An ArrayIndexOutOfBoundsException is thrown
if the normComponents array is not large enough to hold
all the color and alpha components (starting at
normOffset). If the obj variable is
null, a new array will be allocated. If
obj is not null, it must be a primitive
array of type transferType; otherwise, a
ClassCastException is thrown. An
ArrayIndexOutOfBoundsException is thrown if
obj is not large enough to hold a pixel value for this
ColorModel.
Since ColorModel is an abstract class,
any instance is an instance of a subclass. The default implementation
of this method in this abstract class first converts from the
normalized form to the unnormalized form and then calls
getDataElement(int[], int, Object). Subclasses which may
have instances which do not support the unnormalized form must
override this method.
Returns: an Object which is a primitive data array representation of a pixel
Parameters:
- normComponents - an array of normalized color and alpha components
- normOffset - the index into normComponents at which to begin retrieving color and alpha components
- obj - a primitive data array to hold the returned pixel
Throws:
- ClassCastException - if obj is not a primitive array of type transferType
- ArrayIndexOutOfBoundsException - if obj is not large enough to hold a pixel value for this ColorModel or the normComponents array is not large enough to hold all of the color and alpha components starting at normOffset
Since: 1.4
See Also: WritableRaster.setDataElements(int, int, java.lang.Object), SampleModel.setDataElements(int, int, java.lang.Object, java.awt.image.DataBuffer),

public Object getDataElements (int[] components, int offset, Object pixel) [Overrides ColorModel]

Returns a data element array representation of a pixel in this ColorModel given an array of unnormalized color/alpha components.

Returns a data element array representation of a pixel in this ColorModel given an array of unnormalized color/alpha components. This array can then be passed to the setDataElements method of a WritableRaster object. An ArrayIndexOutOfBoundsException is thrown if the components array is not large enough to hold all of the color and alpha components starting at offset. 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.

Since IndexColorModel 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
Returns: an Object representing an array of color and alpha components.
Parameters:
- components - an array of unnormalized color and alpha components
- offset - the index into components at which to begin retrieving color and alpha components
- pixel - the Object representing an array of color and alpha components
Throws:
- ClassCastException - if pixel is not a primitive array of type transferType
- ArrayIndexOutOfBoundsException - if pixel is not large enough to hold a pixel value for this ColorModel or the components array is not large enough to hold all of the color and alpha components starting at offset
- UnsupportedOperationException - if transferType is not one of the supported transer types
See Also: WritableRaster.setDataElements(int, int, java.lang.Object), SampleModel.setDataElements(int, int, java.lang.Object, java.awt.image.DataBuffer),

publicsynchronized Object getDataElements (int rgb, Object pixel) [Overrides ColorModel]

Returns a data element array representation of a pixel in this ColorModel, given an integer pixel representation in the default RGB color model.

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 IndexColorModel 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.
Returns: an array representation of the specified pixel in this IndexColorModel.
Parameters:
- rgb - the integer pixel representation in the default RGB color model
- pixel - the specified pixel
Throws:
- ClassCastException - if pixel is not a primitive array of type transferType
- ArrayIndexOutOfBoundsException - if pixel is not large enough to hold a pixel value for this ColorModel
- UnsupportedOperationException - if transferType is invalid
See Also: WritableRaster.setDataElements(int, int, java.lang.Object), SampleModel.setDataElements(int, int, java.lang.Object, java.awt.image.DataBuffer),

pack-privatestatic int getDefaultTransferType (int pixel_bits) [Inherited From ColorModel]

pack-privatestatic byte getGray16TosRGB8LUT (ICC_ColorSpace grayCS) [Inherited From ColorModel]

pack-privatestatic byte getGray8TosRGB8LUT (ICC_ColorSpace grayCS) [Inherited From ColorModel]

publicfinal int getGreen (int pixel) [Specified in ColorModel]

Returns the green color component for the specified pixel, scaled from 0 to 255 in the default RGB ColorSpace, sRGB.

public int getGreen (Object inData) [Inherited From ColorModel]

Returns the green color component for the specified pixel, scaled from 0 to 255 in the default RGB ColorSpace, sRGB.

Returns the green color component for the specified pixel, scaled
from 0 to 255 in the default RGB ColorSpace, sRGB. A
color conversion is done if necessary. The pixel value is
specified by an array of data elements of type transferType passed
in as an object reference. The returned value will be a non
pre-multiplied value. For example, if the alpha is premultiplied,
this method divides it out before returning the value. If the
alpha value is 0, the green value is 0. If inData is
not a primitive array of type transferType, a
ClassCastException is thrown. An
ArrayIndexOutOfBoundsException is thrown if
inData is not large enough to hold a pixel value for
this ColorModel.
If this transferType is not supported, a
UnsupportedOperationException will be
thrown. Since
ColorModel is an abstract class, any instance
must be an instance of a subclass. Subclasses inherit the
implementation of this method and if they don't override it, this
method throws an exception if the subclass uses a
transferType other than
DataBuffer.TYPE_BYTE,
DataBuffer.TYPE_USHORT, or
DataBuffer.TYPE_INT.
Returns: the value of the green component of the specified pixel.
Parameters:
- inData - an array of pixel values
Throws:
- ClassCastException - if inData is not a primitive array of type transferType
- ArrayIndexOutOfBoundsException - if inData is not large enough to hold a pixel value for this ColorModel
- UnsupportedOperationException - if this tranferType is not supported by this ColorModel

publicfinal void getGreens (byte[] g)

Copies the array of green color components into the specified array.

Copies the array of green color components into the specified array.
Only the initial entries of the array as specified by
getMapSize are written.
Parameters:
- g - the specified array into which the elements of the array of green color components are copied

pack-privatestatic short getLinearGray16ToOtherGray16LUT (ICC_ColorSpace grayCS) [Inherited From ColorModel]

pack-privatestatic byte getLinearGray16ToOtherGray8LUT (ICC_ColorSpace grayCS) [Inherited From ColorModel]

pack-privatestatic byte getLinearRGB16TosRGB8LUT () [Inherited From ColorModel]

pack-privatestatic byte getLinearRGB8TosRGB8LUT () [Inherited From ColorModel]

publicfinal int getMapSize ()

Returns the size of the color/alpha component arrays in this IndexColorModel.

Returns the size of the color/alpha component arrays in this
IndexColorModel.
Returns: the size of the color and alpha component arrays.

public float getNormalizedComponents (int[] components, int offset, float[] normComponents, int normOffset) [Inherited From ColorModel]

Returns an array of all of the color/alpha components in normalized form, given an unnormalized component array.

Returns an array of all of the color/alpha components in normalized form, given an unnormalized component array. Unnormalized components are unsigned integral values between 0 and 2ⁿ - 1, where n is the number of bits for a particular component. Normalized components are float values between a per component minimum and maximum specified by the ColorSpace object for this ColorModel. An IllegalArgumentException will be thrown if color component values for this ColorModel are not conveniently representable in the unnormalized form. If the normComponents array is null, a new array will be allocated. The normComponents array will be returned. Color/alpha components are stored in the normComponents array starting at normOffset (even if the array is allocated by this method). An ArrayIndexOutOfBoundsException is thrown if the normComponents array is not null and is not large enough to hold all the color and alpha components (starting at normOffset). An IllegalArgumentException is thrown if the components array is not large enough to hold all the color and alpha components starting at offset.

Since ColorModel is an abstract class, any instance is an instance of a subclass. The default implementation of this method in this abstract class assumes that component values for this class are conveniently representable in the unnormalized form. Therefore, subclasses which may have instances which do not support the unnormalized form must override this method.
Returns: an array containing normalized color and alpha components.
Parameters:
- components - an array containing unnormalized components
- offset - the offset into the components array at which to start retrieving unnormalized components
- normComponents - an array that receives the normalized components
- normOffset - the index into normComponents at which to begin storing normalized components
Throws:
- IllegalArgumentException - If the component values for this ColorModel are not conveniently representable in the unnormalized form.
- UnsupportedOperationException - if the constructor of this ColorModel called the super(bits) constructor, but did not override this method. See the constructor, {@link #ColorModel(int)}.
- UnsupportedOperationException - if this method is unable to determine the number of bits per component

public float getNormalizedComponents (Object pixel, float[] normComponents, int normOffset) [Inherited From ColorModel]

Returns an array of all of the color/alpha components in normalized form, given a pixel in this ColorModel.

Returns an array of all of the color/alpha components in normalized
form, given a pixel in this ColorModel. The pixel
value is specified by an array of data elements of type transferType
passed in as an object reference. If pixel is not a primitive array
of type transferType, a ClassCastException is thrown.
An ArrayIndexOutOfBoundsException is thrown if
pixel is not large enough to hold a pixel value for this
ColorModel.
Normalized components are float values between a per component minimum
and maximum specified by the ColorSpace object for this
ColorModel. If the
normComponents array is null, a new array
will be allocated. The normComponents array
will be returned. Color/alpha components are stored in the
normComponents array starting at
normOffset (even if the array is allocated by this
method). An ArrayIndexOutOfBoundsException is thrown
if the normComponents array is not null
and is not large enough to hold all the color and alpha components
(starting at normOffset).
Since ColorModel is an abstract class,
any instance is an instance of a subclass. The default implementation
of this method in this abstract class first retrieves color and alpha
components in the unnormalized form using
getComponents(Object, int[], int) and then calls
getNormalizedComponents(int[], int, float[], int).
Subclasses which may
have instances which do not support the unnormalized form must
override this method.
Returns: an array containing normalized color and alpha components.
Parameters:
- pixel - the specified pixel
- normComponents - an array to receive the normalized components
- normOffset - the offset into the normComponents array at which to start storing normalized components
Throws:
- ClassCastException - if pixel is not a primitive array of type transferType
- ArrayIndexOutOfBoundsException - if normComponents is not large enough to hold all color and alpha components starting at normOffset
- ArrayIndexOutOfBoundsException - if pixel is not large enough to hold a pixel value for this ColorModel.
- UnsupportedOperationException - if the constructor of this ColorModel called the super(bits) constructor, but did not override this method. See the constructor, {@link #ColorModel(int)}.
- UnsupportedOperationException - if this method is unable to determine the number of bits per component
Since: 1.4

public int getNumColorComponents () [Inherited From ColorModel]

Returns the number of color components in this ColorModel.

Returns the number of color components in this
ColorModel.
This is the number of components returned by
ColorSpace.getNumComponents().
Returns: the number of color components in this ColorModel.
See Also: ColorSpace.getNumComponents(),

public int getNumComponents () [Inherited From ColorModel]

Returns the number of components, including alpha, in this ColorModel.

Returns the number of components, including alpha, in this
ColorModel. This is equal to the number of color
components, optionally plus one, if there is an alpha component.
Returns: the number of components in this ColorModel

public int getPixelSize () [Inherited From ColorModel]

Returns the number of bits per pixel described by this ColorModel.

Returns the number of bits per pixel described by this
ColorModel.
Returns: the number of bits per pixel.

publicfinal int getRed (int pixel) [Specified in ColorModel]

Returns the red color component for the specified pixel, scaled from 0 to 255 in the default RGB ColorSpace, sRGB.

public int getRed (Object inData) [Inherited From ColorModel]

Returns the red color component for the specified pixel, scaled from 0 to 255 in the default RGB ColorSpace, sRGB.

Returns the red color component for the specified pixel, scaled
from 0 to 255 in the default RGB ColorSpace, sRGB. A
color conversion is done if necessary. The pixel value is
specified by an array of data elements of type transferType passed
in as an object reference. The returned value is a non
pre-multiplied value. For example, if alpha is premultiplied,
this method divides it out before returning
the value. If the alpha value is 0, the red value is 0.
If inData is not a primitive array of type
transferType, a ClassCastException is thrown. An
ArrayIndexOutOfBoundsException is thrown if
inData is not large enough to hold a pixel value for
this ColorModel.
If this transferType is not supported, a
UnsupportedOperationException will be
thrown. Since
ColorModel is an abstract class, any instance
must be an instance of a subclass. Subclasses inherit the
implementation of this method and if they don't override it, this
method throws an exception if the subclass uses a
transferType other than
DataBuffer.TYPE_BYTE,
DataBuffer.TYPE_USHORT, or
DataBuffer.TYPE_INT.
Returns: the value of the red component of the specified pixel.
Parameters:
- inData - an array of pixel values
Throws:
- ClassCastException - if inData is not a primitive array of type transferType
- ArrayIndexOutOfBoundsException - if inData is not large enough to hold a pixel value for this ColorModel
- UnsupportedOperationException - if this tranferType is not supported by this ColorModel

publicfinal void getReds (byte[] r)

Copies the array of red color components into the specified array.

publicfinal int getRGB (int pixel) [Overrides ColorModel]

Returns the color/alpha components of the pixel in the default RGB color model format.

public int getRGB (Object inData) [Inherited From ColorModel]

Returns the color/alpha components for the specified pixel in the default RGB color model format.

Returns the color/alpha components for the specified pixel in the
default RGB color model format. A color conversion is done if
necessary. The pixel value is specified by an array of data
elements of type transferType passed in as an object reference.
If inData is not a primitive array of type transferType, a
ClassCastException is thrown. An
ArrayIndexOutOfBoundsException is
thrown if inData is not large enough to hold a pixel
value for this ColorModel.
The returned value will be in a non pre-multiplied format, i.e. if
the alpha is premultiplied, this method will divide it out of the
color components (if the alpha value is 0, the color values will be 0).
Returns: the color and alpha components of the specified pixel.
Parameters:
- inData - the specified pixel
See Also: ColorModel.getRGBdefault(),

publicstatic ColorModel getRGBdefault () [Inherited From ColorModel]

Returns a DirectColorModel that describes the default format for integer RGB values used in many of the methods in the AWT image interfaces for the convenience of the programmer.

Returns a DirectColorModel that describes the default
format for integer RGB values used in many of the methods in the
AWT image interfaces for the convenience of the programmer.
The color space is the default ColorSpace, sRGB.
The format for the RGB values is an integer with 8 bits
each of alpha, red, green, and blue color components ordered
correspondingly from the most significant byte to the least
significant byte, as in: 0xAARRGGBB. Color components are
not premultiplied by the alpha component. This format does not
necessarily represent the native or the most efficient
ColorModel for a particular device or for all images.
It is merely used as a common color model format.
Returns: a DirectColorModelobject describing default RGB values.

publicfinal void getRGBs (int[] rgb)

Converts data for each index from the color and alpha component arrays to an int in the default RGB ColorModel format and copies the resulting 32-bit ARGB values into the specified array.

Converts data for each index from the color and alpha component
arrays to an int in the default RGB ColorModel format and copies
the resulting 32-bit ARGB values into the specified array. Only
the initial entries of the array as specified by
getMapSize are
written.
Parameters:
- rgb - the specified array into which the converted ARGB values from this array of color and alpha components are copied.

pack-privatestatic short getsRGB8ToLinearRGB16LUT () [Inherited From ColorModel]

pack-privatestatic byte getsRGB8ToLinearRGB8LUT () [Inherited From ColorModel]

publicfinal int getTransferType () [Inherited From ColorModel]

Returns the transfer type of this ColorModel.

Returns the transfer type of this ColorModel.
The transfer type is the type of primitive array used to represent
pixel values as arrays.
Returns: the transfer type.
Since: 1.3

public int getTransparency () [Overrides ColorModel]

Returns the transparency.

Returns the transparency. Returns either OPAQUE, BITMASK,
or TRANSLUCENT
Returns: the transparency of this IndexColorModel
See Also: Transparency.OPAQUE, Transparency.BITMASK, Transparency.TRANSLUCENT,

publicfinal int getTransparentPixel ()

Returns the index of a transparent pixel in this IndexColorModel or -1 if there is no pixel with an alpha value of 0.

Returns the index of a transparent pixel in this
IndexColorModel or -1 if there is no pixel
with an alpha value of 0. If a transparent pixel was
explicitly specified in one of the constructors by its
index, then that index will be preferred, otherwise,
the index of any pixel which happens to be fully transparent
may be returned.
Returns: the index of a transparent pixel in this IndexColorModel object, or -1 if there is no such pixel

public int getUnnormalizedComponents (float[] normComponents, int normOffset, int[] components, int offset) [Inherited From ColorModel]

Returns an array of all of the color/alpha components in unnormalized form, given a normalized component array.

Returns an array of all of the color/alpha components in unnormalized
form, given a normalized component array. Unnormalized components
are unsigned integral values between 0 and 2ⁿ - 1, where
n is the number of bits for a particular component. Normalized
components are float values between a per component minimum and
maximum specified by the ColorSpace object for this
ColorModel. An IllegalArgumentException
will be thrown if color component values for this
ColorModel are not conveniently representable in the
unnormalized form. If the
components array is null, a new array
will be allocated. The components array will
be returned. Color/alpha components are stored in the
components array starting at offset (even
if the array is allocated by this method). An
ArrayIndexOutOfBoundsException is thrown if the
components array is not null and is not
large enough to hold all the color and alpha
components (starting at offset). An
IllegalArgumentException is thrown if the
normComponents array is not large enough to hold
all the color and alpha components starting at
normOffset.
Returns: an array containing unnormalized color and alpha components.
Parameters:
- normComponents - an array containing normalized components
- normOffset - the offset into the normComponents array at which to start retrieving normalized components
- components - an array that receives the components from normComponents
- offset - the index into components at which to begin storing normalized components from normComponents
Throws:
- IllegalArgumentException - If the component values for this ColorModel are not conveniently representable in the unnormalized form.
- IllegalArgumentException - if the length of normComponents minus normOffset is less than numComponents
- UnsupportedOperationException - if the constructor of this ColorModel called the super(bits) constructor, but did not override this method. See the constructor, {@link #ColorModel(int)}.

public BigInteger getValidPixels ()

Returns a BigInteger that indicates the valid/invalid pixels in the colormap.

Returns a BigInteger that indicates the valid/invalid
pixels in the colormap. A bit is valid if the
BigInteger value at that index is set, and is invalid
if the BigInteger value at that index is not set.
The only valid ranges to query in the BigInteger are
between 0 and the map size.
Returns: a BigInteger indicating the valid/invalid pixels.
Since: 1.3

publicfinal boolean hasAlpha () [Inherited From ColorModel]

Returns whether or not alpha is supported in this ColorModel.

Returns whether or not alpha is supported in this
ColorModel.
Returns: true if alpha is supported in this ColorModel; false otherwise.

public int hashCode () [Inherited From ColorModel]

Returns the hash code for this ColorModel.

publicfinal boolean isAlphaPremultiplied () [Inherited From ColorModel]

Returns whether or not the alpha has been premultiplied in the pixel values to be translated by this ColorModel.

Returns whether or not the alpha has been premultiplied in the
pixel values to be translated by this ColorModel.
If the boolean is true, this ColorModel
is to be used to interpret pixel values in which color and alpha
information are represented as separate spatial bands, and color
samples are assumed to have been multiplied by the
alpha sample.
Returns: true if the alpha values are premultiplied in the pixel values to be translated by this ColorModel; false otherwise.

public boolean isCompatibleRaster (Raster raster) [Overrides ColorModel]

Returns true if raster is compatible with this ColorModel or false if it is not compatible with this ColorModel.

Returns true if raster is compatible
with this ColorModel or false if it
is not compatible with this ColorModel.
Returns: true if raster is compatible with this ColorModel; false otherwise.
Parameters:
- raster - the {@link Raster} object to test for compatibility

public boolean isCompatibleSampleModel (SampleModel sm) [Overrides ColorModel]

Checks if the specified SampleModel is compatible with this ColorModel.

Checks if the specified SampleModel is compatible
with this ColorModel. If sm is
null, this method returns false.
Returns: true if the specified SampleModel is compatible with this ColorModel; false otherwise.
Parameters:
- sm - the specified SampleModel, or null
See Also: SampleModel,

pack-privatestatic boolean isLinearGRAYspace (ColorSpace cs) [Inherited From ColorModel]

pack-privatestatic boolean isLinearRGBspace (ColorSpace cs) [Inherited From ColorModel]

public boolean isValid ()

Returns whether or not all of the pixels are valid.

Returns whether or not all of the pixels are valid.
Returns: true if all pixels are valid; false otherwise.
Since: 1.3

public boolean isValid (int pixel)

Returns whether or not the pixel is valid.

Returns whether or not the pixel is valid.
Returns: true if pixel is valid; false otherwise.
Parameters:
- pixel - the specified pixel value
Since: 1.3

pack-privatestatic void loadLibraries () [Inherited From ColorModel]

public String toString () [Overrides ColorModel]

Returns the String representation of the contents of this ColorModelobject.

Returns the String representation of the contents of
this ColorModelobject.
Returns: a String representing the contents of this ColorModel object.