Overview | Package | Class | Use | Tree | Deprecated | Index | Help
| JavaTM 2 Platform Std. Ed. v1.3.1
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## java.awt.image
Class IndexColorModel

    java.lang.Object
      |
      +--java.awt.image.ColorModel
            |
            +--java.awt.image.IndexColorModel

All Implemented Interfaces:
  Transparency

public class IndexColorModel
extends ColorModel

The `IndexColorModel` class is a `ColorModel` class that works with pixel values consisting of a single sample which is an index into a fixed colormap in the default sRGB ColorSpace. The colormap specifies red, green, blue, and optional alpha components corresponding to each index. All components are represented in the colormap as 8-bit unsigned integral values. If alpha is not present, an opaque alpha component (alpha = 1.0) is assumed for each entry. An optional transparent pixel value can be supplied that indicates a completely transparent pixel, regardless of any alpha component recorded for that pixel value. Note that alpha values in `IndexColorModel` objects are never premultiplied. This color model is similar to an X11 PseudoColor visual.

The index represented by a pixel value is stored in the least significant n bits of the pixel representations passed to the methods of this class, where n is the pixel size specified to the constructor for a particular `IndexColorModel` object and n must be between 1 and 16. Higher order bits in pixel representations are assumed to be zero. For those methods that use a primitive array pixel representation of type `transferType`, the array length is always one. The transfer types supported are DataBuffer.TYPE_BYTE and DataBuffer.TYPE_USHORT. A single int pixel representation is valid for all objects of this class, since it is always possible to represent pixel values used with this class in a single int. Therefore, methods that use this representation do not throw an `IllegalArgumentException` due to an invalid pixel value.

Many of the methods in this class are final. The reason for this is that the underlying native graphics code makes assumptions about the layout and operation of this class and those assumptions are reflected in the implementations of the methods here that are marked final. You can subclass this class for other reaons, but you cannot override or modify the behaviour of those methods.

See Also:
  `ColorModel`, `ColorSpace`, `DataBuffer`

Fields inherited from class java.awt.image.ColorModel
`pixel_bits, transferType`

Fields inherited from interface java.awt.Transparency
`BITMASK, OPAQUE, TRANSLUCENT`

Constructor Summary
`IndexColorModel(int bits, int size, byte[] r, byte[] g, byte[] b)` Constructs an `IndexColorModel` from the specified arrays of red, green, and blue components.
`IndexColorModel(int bits, int size, byte[] r, byte[] g, byte[] b, byte[] a)` Constructs an `IndexColorModel` from the given arrays of red, green, blue and alpha components.
`IndexColorModel(int bits, int size, byte[] r, byte[] g, byte[] b, int trans)` Constructs an `IndexColorModel` from the given arrays of red, green, and blue components.
`IndexColorModel(int bits, int size, byte[] cmap, int start, boolean hasalpha)` Constructs an `IndexColorModel` from a single array of interleaved red, green, blue and optional alpha components.
`IndexColorModel(int bits, int size, byte[] cmap, int start, boolean hasalpha, int trans)` Constructs an `IndexColorModel` from a single array of interleaved red, green, blue and optional alpha components.
`IndexColorModel(int bits, int size, int[] cmap, int start, boolean hasalpha, int trans, int transferType)` Constructs an `IndexColorModel` from an array of ints where each int is comprised of red, green, blue, and optional alpha components in the default RGB color model format.
`IndexColorModel(int bits, int size, int[] cmap, int start, int transferType, BigInteger validBits)` Constructs an `IndexColorModel` from an `int` array where each `int` is comprised of red, green, blue, and alpha components in the default RGB color model format.

Method Summary
`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`.
`SampleModel` | `createCompatibleSampleModel(int w, int h)` Creates a `SampleModel` with the specified width and height that has a data layout compatible with this `ColorModel`.
`WritableRaster` | `createCompatibleWritableRaster(int w, int h)` Creates a `WritableRaster` with the specified width and height that has a data layout (`SampleModel`) compatible with this `ColorModel`.
`void` | `finalize()` Disposes of system resources associated with this `ColorModel` once this `ColorModel` is no longer referenced.
`int` | `getAlpha(int pixel)` Returns the alpha component for the specified pixel, scaled from 0 to 255.
`void` | `getAlphas(byte[] a)` Copies the array of alpha transparency components into the specified array.
`int` | `getBlue(int pixel)` Returns the blue color component for the specified pixel, scaled from 0 to 255 in the default RGB ColorSpace, sRGB.
`void` | `getBlues(byte[] b)` Copies the array of blue color components into the specified array.
`int[]` | `getComponents(int pixel, int[] components, int offset)` Returns an array of unnormalized color/alpha components for a specified pixel in this `ColorModel`.
`int[]` | `getComponents(Object pixel, int[] components, int offset)` Returns an array of unnormalized color/alpha components for a specified pixel in this `ColorModel`.
`int[]` | `getComponentSize()` Returns an array of the number of bits for each color/alpha component.
`int` | `getDataElement(int[] components, int offset)` Returns a pixel value represented as an int in this `ColorModel` given an array of unnormalized color/alpha components.
`Object` | `getDataElements(int[] components, int offset, Object pixel)` Returns a data element array representation of a pixel in this `ColorModel` given an array of unnormalized color/alpha components.
`Object` | `getDataElements(int rgb, 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.
`int` | `getGreen(int pixel)` Returns the green color component for the specified pixel, scaled from 0 to 255 in the default RGB ColorSpace, sRGB.
`void` | `getGreens(byte[] g)` Copies the array of green color components into the specified array.
`int` | `getMapSize()` Returns the size of the color/alpha component arrays in this `IndexColorModel`.
`int` | `getRed(int pixel)` Returns the red color component for the specified pixel, scaled from 0 to 255 in the default RGB ColorSpace, sRGB.
`void` | `getReds(byte[] r)` Copies the array of red color components into the specified array.
`int` | `getRGB(int pixel)` Returns the color/alpha components of the pixel in the default RGB color model format.
`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.
`int` | `getTransparency()` Returns the transparency.
`int` | `getTransparentPixel()` Returns the index of the transparent pixel in this `IndexColorModel` or -1 if there is no transparent pixel.
`BigInteger` | `getValidPixels()` Returns a `BigInteger` that indicates the valid/invalid pixels in the colormap.
`boolean` | `isCompatibleRaster(Raster raster)` Returns `true` if `raster` is compatible with this `ColorModel` or `false` if it is not compatible with this `ColorModel`.
`boolean` | `isCompatibleSampleModel(SampleModel sm)` Checks if the specified `SampleModel` is compatible with this `ColorModel`.
`boolean` | `isValid()` Returns whether or not all of the pixels are valid.
`boolean` | `isValid(int pixel)` Returns whether or not the pixel is valid.
`String` | `toString()` Returns the `String` representation of the contents of this `ColorModel`object.

Methods inherited from class java.awt.image.ColorModel
`coerceData, equals, getAlpha, getAlphaRaster, getBlue, getColorSpace, getComponentSize, getGreen, getNormalizedComponents, getNumColorComponents, getNumComponents, getPixelSize, getRed, getRGB, getRGBdefault, getTransferType, getUnnormalizedComponents, hasAlpha, hashCode, isAlphaPremultiplied`

Methods inherited from class java.lang.Object
`clone, getClass, notify, notifyAll, wait, wait, wait`

Constructor Detail

### IndexColorModel

    public IndexColorModel(int bits,
                           int size,
                           byte[] r,
                           byte[] g,
                           byte[] b)

  Constructs an `IndexColorModel` from the specified arrays of red, green, and blue components. Pixels described by this color model all have alpha components of 255 unnormalized (1.0 normalized), which means they are fully opaque. All of the arrays specifying the color components must have at least the specified number of entries. The `ColorSpace` is the default sRGB space. The transparency value is Transparency.OPAQUE. The transfer type is the smallest of DataBuffer.TYPE_BYTE or DataBuffer.TYPE_USHORT that can hold a single pixel.
  Parameters:
    `bits` - the number of bits each pixel occupies
    `size` - the size of the color component arrays
    `r` - the array of red color components
    `g` - the array of green color components
    `b` - the array of blue color components
  Throws:
    `IllegalArgumentException` - if `bits` is less than 1 or greater than 16
    `IllegalArgumentException` - if `size` is less than 1

### IndexColorModel

    public IndexColorModel(int bits,
                           int size,
                           byte[] r,
                           byte[] g,
                           byte[] b,
                           int trans)

  Constructs an `IndexColorModel` from the given arrays of red, green, and blue components. Pixels described by this color model all have alpha components of 255 unnormalized (1.0 normalized), which means they are fully opaque, except for the indicated transparent pixel. All of the arrays specifying the color components must have at least the specified number of entries. The ColorSpace is the default sRGB space. The transparency value is Transparency.BITMASK. The transfer type is the smallest of DataBuffer.TYPE_BYTE or DataBuffer.TYPE_USHORT that can hold a single pixel.
  Parameters:
    `bits` - the number of bits each pixel occupies
    `size` - the size of the color component arrays
    `r` - the array of red color components
    `g` - the array of green color components
    `b` - the array of blue color components
    `trans` - the index of the transparent pixel
  Throws:
    `IllegalArgumentException` - if `bits` is less than 1 or greater than 16
    `IllegalArgumentException` - if `size` is less than 1

### IndexColorModel

    public IndexColorModel(int bits,
                           int size,
                           byte[] r,
                           byte[] g,
                           byte[] b,
                           byte[] a)

  Constructs an `IndexColorModel` from the given arrays of red, green, blue and alpha components. All of the arrays specifying the components must have at least the specified number of entries. The ColorSpace is the default sRGB space. The transparency value is Transparency.TRANSLUCENT. The transfer type is the smallest of DataBuffer.TYPE_BYTE or DataBuffer.TYPE_USHORT that can hold a single pixel.
  Parameters:
    `bits` - the number of bits each pixel occupies
    `size` - the size of the color component arrays
    `r` - the array of red color components
    `g` - the array of green color components
    `b` - the array of blue color components
    `a` - the array of alpha value components
  Throws:
    `IllegalArgumentException` - if `bits` is less than 1 or greater than 16
    `IllegalArgumentException` - if `size` is less than 1

### IndexColorModel

    public IndexColorModel(int bits,
                           int size,
                           byte[] cmap,
                           int start,
                           boolean hasalpha)

  Constructs an `IndexColorModel` from a single array of interleaved red, green, blue and optional alpha components. The array must have enough values in it to fill all of the needed component arrays of the specified size. The ColorSpace is the default sRGB space. The transparency value is Transparency.TRANSLUCENT if `hasAlpha` is `true`, Transparency.OPAQUE otherwise. The transfer type is the smallest of DataBuffer.TYPE_BYTE or DataBuffer.TYPE_USHORT that can hold a single pixel.
  Parameters:
    `bits` - the number of bits each pixel occupies
    `size` - the size of the color component arrays
    `cmap` - the array of color components
    `start` - the starting offset of the first color component
    `hasalpha` - indicates whether alpha values are contained in the `cmap` array
  Throws:
    `IllegalArgumentException` - if `bits` is less than 1 or greater than 16
    `IllegalArgumentException` - if `size` is less than 1

### IndexColorModel

    public IndexColorModel(int bits,
                           int size,
                           byte[] cmap,
                           int start,
                           boolean hasalpha,
                           int trans)

  Constructs an `IndexColorModel` from a single array of interleaved red, green, blue and optional alpha components. The specified transparent index represents a pixel that is considered entirely transparent regardless of any alpha value specified for it. The array must have enough values in it to fill all of the needed component arrays of the specified size. The ColorSpace is the default sRGB space. The transparency value is Transparency.TRANSLUCENT if `hasAlpha` is `true`; otherwise it is Transparency.BITMASK if `trans` is a valid index into the colormap (between 0 and size - 1) or Transparency.OPAQUE if `trans` is not a valid index. The transfer type is the smallest of DataBuffer.TYPE_BYTE or DataBuffer.TYPE_USHORT that can hold a single pixel.
  Parameters:
    `bits` - the number of bits each pixel occupies
    `size` - the size of the color component arrays
    `cmap` - the array of color components
    `start` - the starting offset of the first color component
    `hasalpha` - indicates whether alpha values are contained in the `cmap` array
    `trans` - the index of the fully transparent pixel
  Throws:
    `IllegalArgumentException` - if `bits` is less than 1 or greater than 16
    `IllegalArgumentException` - if `size` is less than 1

### IndexColorModel

    public IndexColorModel(int bits,
                           int size,
                           int[] cmap,
                           int start,
                           boolean hasalpha,
                           int trans,
                           int transferType)

  Constructs an `IndexColorModel` from an array of ints where each int is comprised of red, green, blue, and optional alpha components in the default RGB color model format. The specified transparent index represents a pixel that is considered entirely transparent regardless of any alpha value specified for it. The array must have enough values in it to fill all of the needed component arrays of the specified size. The ColorSpace is the default sRGB space. The transparency value is Transparency.TRANSLUCENT if `hasAlpha` is `true`; otherwise it is Transparency.BITMASK if `trans` is a valid index into the colormap (between 0 and size - 1) or Transparency.OPAQUE if `trans` is not a valid index.
  Parameters:
    `bits` - the number of bits each pixel occupies
    `size` - the size of the color component arrays
    `cmap` - the array of color components
    `start` - the starting offset of the first color component
    `hasalpha` - indicates whether alpha values are contained in the `cmap` array
    `trans` - the index of the fully transparent pixel
    `transferType` - the data type of the array used to represent pixel values. The data type must be either `DataBuffer.TYPE_BYTE` or `DataBuffer.TYPE_USHORT`.
  Throws:
    `IllegalArgumentException` - if `bits` is less than 1 or greater than 16
    `IllegalArgumentException` - if `size` is less than 1

### IndexColorModel

    public IndexColorModel(int bits,
                           int size,
                           int[] cmap,
                           int start,
                           int transferType,
                           BigInteger validBits)

  Constructs an `IndexColorModel` from an `int` array where each `int` is comprised of red, green, blue, and alpha components in the default RGB color model format. The array must have enough values in it to fill all of the needed component arrays of the specified size. The `ColorSpace` is the default sRGB space. The transfer type is the smallest of DataBuffer.TYPE_BYTE, DataBuffer.TYPE_USHORT, or DataBuffer.TYPE_INT that can hold a single pixel. The `BigInteger` object specifies the valid/invalid pixels in the `cmap` array. A pixel is valid if the `BigInteger` value at that index is set, and is invalid if the `BigInteger` bit at that index is not set.
  Parameters:
    `bits` - the number of bits each pixel occupies
    `size` - the size of the color component array
    `cmap` - the array of color components
    `start` - the starting offset of the first color component
    `transferType` - the specified data type
    `validBits` - a `BigInteger` object. If a bit is set in the BigInteger, the pixel at that index is valid. If a bit is not set, the pixel at that index is considered invalid. If null, all pixels are valid. Only bits from 0 to map_size will be considered.

Method Detail

### getTransparency

    public int getTransparency()

  Returns the transparency. Returns either OPAQUE, BITMASK, or TRANSLUCENT
  Overrides:
    `getTransparency` in class `ColorModel`
  Returns:
    the transparency of this `IndexColorModel`
  See Also:
    `Transparency.OPAQUE`, `Transparency.BITMASK`, `Transparency.TRANSLUCENT`

### getComponentSize

    public int[] getComponentSize()

  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.
  Overrides:
    `getComponentSize` in class `ColorModel`
  Returns:
    an array containing the number of bits of each color and alpha component of this `IndexColorModel`

### getMapSize

    public final int getMapSize()

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

### getTransparentPixel

    public final int getTransparentPixel()

  Returns the index of the transparent pixel in this `IndexColorModel` or -1 if there is no transparent pixel.
  Returns:
    the index of this `IndexColorModel` object's transparent pixel, or -1 if there is no such pixel.

### getReds

    public final void getReds(byte[] r)

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

### getGreens

    public final void getGreens(byte[] g)

  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

### getBlues

    public final void getBlues(byte[] b)

  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

### getAlphas

    public final void getAlphas(byte[] a)

  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

### getRGBs

    public final 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. 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.

### getRed

    public final int getRed(int pixel)

  Returns the red color component for the specified pixel, scaled from 0 to 255 in the default RGB ColorSpace, sRGB. The pixel value is specified as an int. The returned value is a non pre-multiplied value.
  Overrides:
    `getRed` in class `ColorModel`
  Parameters:
    `pixel` - the specified pixel
  Returns:
    the value of the red color component for the specified pixel

### getGreen

    public final int getGreen(int pixel)

  Returns the green color component for the specified pixel, scaled from 0 to 255 in the default RGB ColorSpace, sRGB. The pixel value is specified as an int. The returned value is a non pre-multiplied value.
  Overrides:
    `getGreen` in class `ColorModel`
  Parameters:
    `pixel` - the specified pixel
  Returns:
    the value of the green color component for the specified pixel

### getBlue

    public final int getBlue(int pixel)

  Returns the blue color component for the specified pixel, scaled from 0 to 255 in the default RGB ColorSpace, sRGB. The pixel value is specified as an int. The returned value is a non pre-multiplied value.
  Overrides:
    `getBlue` in class `ColorModel`
  Parameters:
    `pixel` - the specified pixel
  Returns:
    the value of the blue color component for the specified pixel

### getAlpha

    public final int getAlpha(int pixel)

  Returns the alpha component for the specified pixel, scaled from 0 to 255. The pixel value is specified as an int.
  Overrides:
    `getAlpha` in class `ColorModel`
  Parameters:
    `pixel` - the specified pixel
  Returns:
    the value of the alpha component for the specified pixel

### getRGB

    public final int getRGB(int pixel)

  Returns the color/alpha components of the pixel in the default RGB color model format. The pixel value is specified as an int. The returned value is in a non pre-multiplied format.
  Overrides:
    `getRGB` in class `ColorModel`
  Parameters:
    `pixel` - the specified pixel
  Returns:
    the color and alpha components of the specified pixel
  See Also:
    `ColorModel.getRGBdefault()`

### getDataElements

    public Object getDataElements(int rgb,
                                  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 `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`.

  Overrides:
    `getDataElements` in class `ColorModel`
  Parameters:
    `rgb` - the integer pixel representation in the default RGB color model
    `pixel` - the specified pixel
  Returns:
    an array representation of the specified pixel in this `IndexColorModel`.
  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)`

### getComponents

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

  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. The components array is 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`.
  Overrides:
    `getComponents` in class `ColorModel`
  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
  Returns:
    an array containing the color and alpha components of the specified pixel starting at the specified offset.

### getComponents

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

  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. The `components` array is 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 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`.

  Overrides:
    `getComponents` in class `ColorModel`
  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
  Returns:
    an array containing the color and alpha components of the specified pixel starting at the specified offset.
  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

### getDataElement

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

  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.
  Overrides:
    `getDataElement` in class `ColorModel`
  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
  Returns:
    an `int` pixel value in this `ColorModel` corresponding to the specified 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

### getDataElements

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

  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`

  Overrides:
    `getDataElements` in class `ColorModel`
  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
  Returns:
    an `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)`

### createCompatibleWritableRaster

    public WritableRaster createCompatibleWritableRaster(int w,
                                                         int h)

  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.

  Overrides:
    `createCompatibleWritableRaster` in class `ColorModel`
  Parameters:
    `w` - the width to apply to the new `WritableRaster`
    `h` - the height to apply to the new `WritableRaster`
  Returns:
    a `WritableRaster` object with the specified width and height.
  Throws:
    `UnsupportedOperationException` - if the number of bits in a pixel is greater than 16
  See Also:
    `WritableRaster`, `SampleModel`

### isCompatibleRaster

    public boolean isCompatibleRaster(Raster raster)

  Returns `true` if `raster` is compatible with this `ColorModel` or `false` if it is not compatible with this `ColorModel`.
  Overrides:
    `isCompatibleRaster` in class `ColorModel`
  Parameters:
    `raster` - the `Raster` object to test for compatibility
  Returns:
    `true` if `raster` is compatible with this `ColorModel`; `false` otherwise.

### createCompatibleSampleModel

    public SampleModel createCompatibleSampleModel(int w,
                                                   int h)

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

### isCompatibleSampleModel

    public boolean isCompatibleSampleModel(SampleModel sm)

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

### convertToIntDiscrete

    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`. 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.
  Parameters:
    `raster` - the specified `Raster`
    `forceARGB` - if `true`, the returned `BufferedImage` is TYPE_INT_ARGB; otherwise it is TYPE_INT_RGB
  Returns:
    a `BufferedImage` created with the specified `Raster`

### isValid

    public boolean isValid(int pixel)

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

### isValid

    public boolean isValid()

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

### getValidPixels

    public BigInteger getValidPixels()

  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 map_size.
  Returns:
    a `BigInteger` indicating the valid/invalid pixels.

### finalize

    public void finalize()

  Disposes of system resources associated with this `ColorModel` once this `ColorModel` is no longer referenced.
  Overrides:
    `finalize` in class `ColorModel`
  Following copied from class: `java.lang.Object`
  Throws:
    `Throwable` - the `Exception` raised by this method

### toString

    public String toString()

  Returns the `String` representation of the contents of this `ColorModel`object.
  Overrides:
    `toString` in class `ColorModel`
  Returns:
    a `String` representing the contents of this `ColorModel` object.

Overview | Package | Class | Use | Tree | Deprecated | Index | Help
| JavaTM 2 Platform Std. Ed. v1.3.1
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

Submit a bug or feature
For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Java, Java 2D, and JDBC are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries.
Copyright 1993-2001 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.