IndexColorModel (Java Platform SE 8 )

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

All Implemented Interfaces:

Transparency
```
public class IndexColorModel
extends ColorModel
```
IndexColorModel类是一个ColorModel类，适用于由单个样本组成的像素值，该样本是默认sRGB颜色空间中固定色彩映射的索引。颜色映射指定对应于每个索引的红色，绿色，蓝色和可选的alpha组件。所有组件在色彩映射中表示为8位无符号积分值。一些构造函数允许调用者通过指定哪些色彩映射条目有效并通过BigInteger对象中设置的位来表示不可用的颜色来指定色彩映射中的“空洞”。此颜色模型与X11 PseudoColor视觉相似。
一些构造函数提供了指定色彩映射中每个像素的alpha分量的方法，而其他构造函数不提供这样的方法，或者在某些情况下提供一个标志来指示色彩映射数据是否包含alpha值。如果没有向构造函数提供alpha，则会为每个条目假定为不透明的alpha组件（alpha = 1.0）。可以提供可选的透明像素值，其指示要完全透明的像素，而不管为该像素值提供或假设的任何α分量。请注意， IndexColorModel对象的颜色映射中的颜色IndexColorModel决不会与alpha分量预先乘以。

The transparency of an IndexColorModel object is determined by examining the alpha components of the colors in the colormap and choosing the most specific value after considering the optional alpha values and any transparent index specified. The transparency value is Transparency.OPAQUE only if all valid colors in the colormap are opaque and there is no valid transparent pixel. If all valid colors in the colormap are either completely opaque (alpha = 1.0) or completely transparent (alpha = 0.0), which typically occurs when a valid transparent pixel is specified, the value is Transparency.BITMASK. Otherwise, the value is Transparency.TRANSLUCENT, indicating that some valid color has an alpha component that is neither completely transparent nor completely opaque (0.0 < alpha < 1.0).

如果一个IndexColorModel对象的透明度值为Transparency.OPAQUE ，则hasAlpha和getNumComponents方法（都继承自ColorModel ）分别返回false和3。对于任何其他透明度值， hasAlpha返回true， getNumComponents返回4。

The values used to index into the colormap are taken from the least significant n bits of pixel representations where n is based on the pixel size specified in the constructor. For pixel sizes smaller than 8 bits, n is rounded up to a power of two (3 becomes 4 and 5,6,7 become 8). For pixel sizes between 8 and 16 bits, n is equal to the pixel size. Pixel sizes larger than 16 bits are not supported by this class. Higher order bits beyond n are ignored in pixel representations. Index values greater than or equal to the map size, but less than 2ⁿ, are undefined and return 0 for all color and alpha components.

对于使用transferType类型的原始数组像素表示的transferType ，数组长度总是为1。支持的传输类型是DataBuffer.TYPE_BYTE和DataBuffer.TYPE_USHORT 。单个int像素表示对于此类的所有对象是有效的，因为总是可以在单个int中表示与该类一起使用的像素值。因此，由于无效的像素值，使用此表示的方法不会抛出IllegalArgumentException 。

这个类中的很多方法都是最终的。原因是底层本机图形代码对这个类的布局和操作做出假设，这些假设反映在这里标记为final的方法的实现中。您可以通过其他原因对此类进行子类化，但不能覆盖或修改这些方法的行为。

另请参见：

ColorModel ， ColorSpace ， DataBuffer

Field Summary
- Fields inherited from class java.awt.image.ColorModel
  pixel_bits, transferType
- Fields inherited from interface java.awt.Transparency
  BITMASK, OPAQUE, TRANSLUCENT

构造方法摘要

构造方法
Constructor and Description
`IndexColorModel(int bits, int size, byte[] r, byte[] g, byte[] b)` 构造一个 `IndexColorModel`从红色，绿色和蓝色分量指定数组。
`IndexColorModel(int bits, int size, byte[] r, byte[] g, byte[] b, byte[] a)` 构造一个 `IndexColorModel`从红色，绿色，蓝色和alpha分量给定的阵列。
`IndexColorModel(int bits, int size, byte[] r, byte[] g, byte[] b, int trans)` 构造一个 `IndexColorModel`从红色，绿色和蓝色分量给定的阵列。
`IndexColorModel(int bits, int size, byte[] cmap, int start, boolean hasalpha)` 构造一个 `IndexColorModel`从交织红色，绿色，蓝色和可选alpha分量的单个阵列。
`IndexColorModel(int bits, int size, byte[] cmap, int start, boolean hasalpha, int trans)` 构造一个 `IndexColorModel`从交织红色，绿色，蓝色和可选alpha分量的单个阵列。
`IndexColorModel(int bits, int size, int[] cmap, int start, boolean hasalpha, int trans, int transferType)` 从int数组构造一个 `IndexColorModel` ，其中每个int由默认RGB颜色模型格式的红色，绿色，蓝色和可选alpha组件组成。
`IndexColorModel(int bits, int size, int[] cmap, int start, int transferType, BigInteger validBits)` 从 `int`数组构造一个 `IndexColorModel` ，其中每个 `int`由默认RGB颜色模型格式的红色，绿色，蓝色和Alpha组件组成。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`BufferedImage`	`convertToIntDiscrete(Raster raster, boolean forceARGB)` 返回一个新的 `BufferedImage` TYPE_INT_ARGB或TYPE_INT_RGB的具有 `Raster`通过展开源的索引来计算的与像素数据 `Raster`使用此的颜色/ alpha分量数组 `ColorModel` 。
`SampleModel`	`createCompatibleSampleModel(int w, int h)` 创建 `SampleModel`具有指定的宽度和高度，具有与此兼容的数据布局 `ColorModel` 。
`WritableRaster`	`createCompatibleWritableRaster(int w, int h)` 创建 `WritableRaster`具有指定的宽度和高度，其具有的数据布局（ `SampleModel` ）与此兼容 `ColorModel` 。
`void`	`finalize()` 一旦这个 `ColorModel`不再被引用，则处理与此 `ColorModel`的系统资源。
`int`	`getAlpha(int pixel)` 返回指定像素的alpha分量，从0到255。
`void`	`getAlphas(byte[] a)` 将Alpha透明组件数组复制到指定的数组中。
`int`	`getBlue(int pixel)` 返回指定像素的蓝色分量，在默认RGB ColorSpace（sRGB）中从0到255。
`void`	`getBlues(byte[] b)` 将蓝色组件数组复制到指定的数组中。
`int[]`	`getComponents(int pixel, int[] components, int offset)` 返回此 `ColorModel`指定像素的非标准化颜色/ alpha分量 `ColorModel` 。
`int[]`	`getComponents(Object pixel, int[] components, int offset)` 返回此 `ColorModel`指定像素的非标准化颜色/ alpha分量 `ColorModel` 。
`int[]`	`getComponentSize()` 返回每个颜色/ alpha分量的位数的数组。
`int`	`getDataElement(int[] components, int offset)` 返回表示为在此一个int的像素值 `ColorModel`给定非标准化颜色/ alpha分量的阵列。
`Object`	`getDataElements(int[] components, int offset, Object pixel)` 返回此的像素的数据元素数组表示 `ColorModel`给定非标准化颜色/ alpha分量的阵列。
`Object`	`getDataElements(int rgb, Object pixel)` 返回此ColorModel中的像素的数据元素数组表示，给出了默认RGB颜色模型中的整数像素表示。
`int`	`getGreen(int pixel)` 返回指定像素的绿色分量，在默认RGB ColorSpace sRGB中从0到255。
`void`	`getGreens(byte[] g)` 将绿色组件数组复制到指定的数组中。
`int`	`getMapSize()` 返回此 `IndexColorModel`颜色/ alpha组件数组的 `IndexColorModel` 。
`int`	`getRed(int pixel)` 返回指定像素的红色分量，在默认RGB ColorSpace sRGB中从0到255。
`void`	`getReds(byte[] r)` 将红色组件数组复制到指定的数组中。
`int`	`getRGB(int pixel)` 以默认RGB颜色模型格式返回像素的颜色/ alpha分量。
`void`	`getRGBs(int[] rgb)` 将每个索引的数据从颜色和alpha组件数组转换为默认RGB ColorModel格式的int，并将生成的32位ARGB值复制到指定的数组中。
`int`	`getTransparency()` 返回透明度。
`int`	`getTransparentPixel()` 如果没有Alpha值为0的像素，则返回此 `IndexColorModel`中的透明像素的索引或-1。
`BigInteger`	`getValidPixels()` 返回一个 `BigInteger` ，表示色彩映射中有效/无效的像素。
`boolean`	`isCompatibleRaster(Raster raster)` 返回 `true`如果 `raster`与此兼容 `ColorModel`或 `false`如果不是与此兼容 `ColorModel` 。
`boolean`	`isCompatibleSampleModel(SampleModel sm)` 检查指定的 `SampleModel`与此兼容 `ColorModel` 。
`boolean`	`isValid()` 返回所有像素是否有效。
`boolean`	`isValid(int pixel)` 返回像素是否有效。
`String`	`toString()` 返回 `String`这个内容表示 `ColorModel`对象。

Methods inherited from class java.awt.image.ColorModel
coerceData, equals, getAlpha, getAlphaRaster, getBlue, getColorSpace, getComponentSize, getDataElement, getDataElements, getGreen, getNormalizedComponents, 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

- 构造方法详细信息
  - IndexColorModel
```
public IndexColorModel(int bits,
                       int size,
                       byte[] r,
                       byte[] g,
                       byte[] b)
```
    构造一个IndexColorModel从红色，绿色和蓝色分量指定数组。由此颜色模型描述的像素都具有255的非标准化（1.0归一化）的α分量，这意味着它们是完全不透明的。指定颜色分量的所有数组必须至少具有指定数量的条目。 ColorSpace是默认的sRGB空间。由于此构造函数的任何参数中没有alpha信息，透明度值始终为Transparency.OPAQUE 。传输类型是可以容纳单个像素的DataBuffer.TYPE_BYTE或DataBuffer.TYPE_USHORT中最小的。
    
    参数
    
    bits - 每个像素占用的位数
    
    size - 颜色组件数组的大小
    
    r - 红色组件阵列
    
    g - 绿色组件阵列
    
    b - 蓝色组件阵列
    
    异常
    
    IllegalArgumentException - 如果 bits小于1或大于16
    
    IllegalArgumentException - 如果 size小于1
  - IndexColorModel
```
public IndexColorModel(int bits,
                       int size,
                       byte[] r,
                       byte[] g,
                       byte[] b,
                       int trans)
```
    构造一个IndexColorModel从红色，绿色和蓝色分量给定的阵列。由该颜色模型描述的像素都具有255的非标准化（1.0归一化）的α分量，这意味着它们是完全不透明的，除了指示的像素被制成透明。指定颜色分量的所有数组必须至少具有指定数量的条目。 ColorSpace是默认的sRGB空间。透明度值可以是Transparency.OPAQUE或Transparency.BITMASK ，这取决于参数，如上面的class description所规定。传输类型是可以容纳单个像素的DataBuffer.TYPE_BYTE或DataBuffer.TYPE_USHORT中的最小值。
    
    参数
    
    bits - 每个像素占用的位数
    
    size - 颜色组件数组的大小
    
    r - 红色组件阵列
    
    g - 绿色组件阵列
    
    b - 蓝色组件阵列
    
    trans - 透明像素的索引
    
    异常
    
    IllegalArgumentException - 如果 bits小于1或大于16
    
    IllegalArgumentException - 如果 size小于1
  - IndexColorModel
```
public IndexColorModel(int bits,
                       int size,
                       byte[] r,
                       byte[] g,
                       byte[] b,
                       byte[] a)
```
    构造一个IndexColorModel从红色，绿色，蓝色和alpha分量给定的阵列。指定组件的所有数组必须至少具有指定数量的条目。 ColorSpace是默认的sRGB空间。透明度值可以是任何的Transparency.OPAQUE ， Transparency.BITMASK ，或Transparency.TRANSLUCENT取决于参数，如在指定class description上方。传输类型是可以容纳单个像素的DataBuffer.TYPE_BYTE或DataBuffer.TYPE_USHORT中的最小值。
    
    参数
    
    bits - 每个像素占用的位数
    
    size - 颜色组件数组的大小
    
    r - 红色组件阵列
    
    g - 绿色组件阵列
    
    b - 蓝色组件阵列
    
    a - alpha值组件数组
    
    异常
    
    IllegalArgumentException - 如果 bits小于1或大于16
    
    IllegalArgumentException - 如果 size小于1
  - IndexColorModel
```
public IndexColorModel(int bits,
                       int size,
                       byte[] cmap,
                       int start,
                       boolean hasalpha)
```
    构造一个IndexColorModel从交织红色，绿色，蓝色和可选alpha分量的单个阵列。数组必须有足够的值来填充指定大小的所有需要的组件数组。 ColorSpace是默认的sRGB空间。透明度值可以是任何的Transparency.OPAQUE ， Transparency.BITMASK ，或Transparency.TRANSLUCENT取决于参数，如在指定class description上方。传输类型是可以容纳单个像素的DataBuffer.TYPE_BYTE或DataBuffer.TYPE_USHORT中的最小值。
    
    参数
    
    bits - 每个像素占用的位数
    
    size - 颜色组件数组的大小
    
    cmap - 颜色分量数组
    
    start - 第一个颜色分量的起始偏移量
    
    hasalpha - 表示alpha值是否包含在 cmap数组中
    
    异常
    
    IllegalArgumentException - 如果 bits小于1或大于16
    
    IllegalArgumentException - 如果 size小于1
  - IndexColorModel
```
public IndexColorModel(int bits,
                       int size,
                       byte[] cmap,
                       int start,
                       boolean hasalpha,
                       int trans)
```
    构造一个IndexColorModel从交织红色，绿色，蓝色和可选alpha分量的单个阵列。指定的透明索引表示完全透明的像素，无论为其指定了任何alpha值。数组必须有足够的值来填充指定大小的所有需要的组件数组。 ColorSpace是默认的sRGB空间。透明度值可以是Transparency.BITMASK或Transparency.TRANSLUCENT任何Transparency.OPAQUE ， Transparency.BITMASK参数，如上面的class description中所指定的。传输类型是可以容纳单个像素的DataBuffer.TYPE_BYTE或DataBuffer.TYPE_USHORT中的最小值。
    
    参数
    
    bits - 每个像素占用的位数
    
    size - 颜色组件数组的大小
    
    cmap - 颜色分量阵列
    
    start - 第一个颜色分量的起始偏移量
    
    hasalpha - 表示alpha值是否包含在 cmap数组中
    
    trans - 完全透明像素的索引
    
    异常
    
    IllegalArgumentException - 如果 bits小于1或大于16
    
    IllegalArgumentException - 如果 size小于1
  - IndexColorModel
```
public IndexColorModel(int bits,
                       int size,
                       int[] cmap,
                       int start,
                       boolean hasalpha,
                       int trans,
                       int transferType)
```
    从int数组构造一个IndexColorModel ，其中每个int由默认RGB颜色模型格式的红色，绿色，蓝色和可选alpha组件组成。指定的透明索引表示完全透明的像素，无论为其指定了任何alpha值。数组必须有足够的值来填充指定大小的所有需要的组件数组。 ColorSpace是默认的sRGB空间。透明度值可以是任何的Transparency.OPAQUE ， Transparency.BITMASK ，或Transparency.TRANSLUCENT取决于参数，如在指定class description上方。
    
    参数
    
    bits - 每个像素占用的位数
    
    size - 颜色组件数组的大小
    
    cmap - 颜色分量阵列
    
    start - 第一个颜色分量的起始偏移量
    
    hasalpha - 表示alpha值是否包含在 cmap数组中
    
    trans - 完全透明像素的索引
    
    transferType - 用于表示像素值的数组的数据类型。数据类型必须是DataBuffer.TYPE_BYTE或DataBuffer.TYPE_USHORT 。
    
    异常
    
    IllegalArgumentException - 如果 bits小于1或大于16
    
    IllegalArgumentException - 如果 size小于1
    
    IllegalArgumentException - 如果 transferType不是 DataBuffer.TYPE_BYTE或 DataBuffer.TYPE_USHORT
  - IndexColorModel
```
public IndexColorModel(int bits,
                       int size,
                       int[] cmap,
                       int start,
                       int transferType,
                       BigInteger validBits)
```
    构造一个IndexColorModel从int阵列，其中每个int包括在默认RGB颜色模型格式的红色，绿色，蓝色，和alpha分量。数组必须有足够的值来填充指定大小的所有需要的组件数组。 ColorSpace是默认的sRGB空间。透明度值可以是Transparency.BITMASK或Transparency.TRANSLUCENT任何Transparency.OPAQUE ， Transparency.BITMASK参数，如上面的class description中所指定的。转移类型必须是DataBuffer.TYPE_BYTE DataBuffer.TYPE_USHORT 。 BigInteger对象指定cmap数组中的有效/无效像素。如果设置了该索引的值为BigInteger则像素有效，如果该索引处的BigInteger位未设置，则该BigInteger无效。
    
    参数
    
    bits - 每个像素占用的位数
    
    size - 颜色组件数组的大小
    
    cmap - 颜色分量阵列
    
    start - 第一个颜色分量的起始偏移量
    
    transferType - 指定的数据类型
    
    validBits - 一个BigInteger对象。如果在BigInteger中设置了一个位，该索引处的像素是有效的。如果未设置位，该索引处的像素被认为是无效的。如果为空，则所有像素均为有效。只考虑从0到地图大小的位。
    
    异常
    
    IllegalArgumentException - 如果 bits小于1或大于16
    
    IllegalArgumentException - 如果 size小于1
    
    IllegalArgumentException - 如果 transferType不是 DataBuffer.TYPE_BYTE或 DataBuffer.TYPE_USHORT
    
    从以下版本开始：
    
    1.3
- 方法详细信息
  - getTransparency
```
public int getTransparency()
```
    返回透明度。返回OPAQUE，BITMASK或TRANSLUCENT
    
    Specified by:
    
    getTransparency在界面 Transparency
    
    重写：
    
    getTransparency在类别 ColorModel
    
    结果
    
    这个IndexColorModel的 IndexColorModel
    
    另请参见：
    
    Transparency.OPAQUE ， Transparency.BITMASK ， Transparency.TRANSLUCENT
  - getComponentSize
```
public int[] getComponentSize()
```
    返回每个颜色/ alpha分量的位数的数组。该阵列包含红色，绿色，蓝色的颜色分量，后面是alpha组件（如果存在）。
    
    重写：
    
    getComponentSize在 ColorModel
    
    结果
    
    一个包含这个IndexColorModel的每个颜色和alpha分量的 IndexColorModel
  - getMapSize
```
public final int getMapSize()
```
    返回此 IndexColorModel颜色/ alpha组件数组的 IndexColorModel 。
    
    结果
    
    颜色和alpha组件数组的大小。
  - getTransparentPixel
```
public final int getTransparentPixel()
```
    如果没有alpha值为0的像素，则返回此 IndexColorModel中的透明像素的索引或-1。如果透明像素在其中一个构造函数中由其索引显式指定，则该索引将是首选，否则，可能会返回恰好完全透明的任何像素的索引。
    
    结果
    
    这个 IndexColorModel对象中的透明像素的索引，如果没有这样的像素则为-1
  - getReds
```
public final void getReds(byte[] r)
```
    将红色组件数组复制到指定的数组中。只写入由getMapSize指定的数组的初始条目。
    
    参数
    
    r - 复制红色组件数组元素的指定数组
  - getGreens
```
public final void getGreens(byte[] g)
```
    将绿色组件数组复制到指定的数组中。仅写入由getMapSize的数组的初始条目。
    
    参数
    
    g - 复制绿色组件数组元素的指定数组
  - getBlues
```
public final void getBlues(byte[] b)
```
    将蓝色组件数组复制到指定的数组中。仅写入由getMapSize的数组的初始条目。
    
    参数
    
    b - 复制了蓝色组件数组元素的指定数组
  - getAlphas
```
public final void getAlphas(byte[] a)
```
    将Alpha透明组件数组复制到指定的数组中。只写入由getMapSize的数组的初始条目。
    
    参数
    
    a - 复制alpha组件数组元素的指定数组
  - getRGBs
```
public final void getRGBs(int[] rgb)
```
    将每个索引的数据从颜色和alpha组件数组转换为默认RGB ColorModel格式的int，并将生成的32位ARGB值复制到指定的数组中。仅写入由getMapSize的数组的初始条目。
    
    参数
    
    rgb - 从该数组的颜色和alpha组件复制转换的ARGB值的指定数组。
  - getRed
```
public final int getRed(int pixel)
```
    返回指定像素的红色分量，在默认RGB ColorSpace sRGB中从0到255。像素值被指定为int。只有像素值的较低n位，如在指定class description以上，用于计算返回的值。返回的值是非预先乘以的值。
    
    Specified by:
    
    getRed在 ColorModel
    
    参数
    
    pixel - 指定像素
    
    结果
    
    指定像素的红色分量的值
  - getGreen
```
public final int getGreen(int pixel)
```
    返回指定像素的绿色分量，在默认RGB ColorSpace sRGB中从0到255。像素值被指定为int。只有像素值的较低n位，如在指定class description以上，用于计算返回的值。返回的值是非预先乘以的值。
    
    Specified by:
    
    getGreen在类别 ColorModel
    
    参数
    
    pixel - 指定的像素
    
    结果
    
    指定像素的绿色分量的值
  - getBlue
```
public final int getBlue(int pixel)
```
    返回指定像素的蓝色分量，在默认RGB ColorSpace（sRGB）中从0到255。像素值被指定为int。只有像素值的较低n位，如在指定class description以上，用于计算返回的值。返回的值是非预先乘以的值。
    
    Specified by:
    
    getBlue在类别 ColorModel
    
    参数
    
    pixel - 指定的像素
    
    结果
    
    指定像素的蓝色分量的值
  - getAlpha
```
public final int getAlpha(int pixel)
```
    返回指定像素的alpha分量，从0到255。像素值被指定为int。只有像素值的较低n位，如在指定class description以上，用于计算返回的值。
    
    Specified by:
    
    getAlpha在 ColorModel
    
    参数
    
    pixel - 指定的像素
    
    结果
    
    指定像素的alpha分量的值
  - getRGB
```
public final int getRGB(int pixel)
```
    以默认RGB颜色模型格式返回像素的颜色/ alpha分量。像素值被指定为int。只有像素值的较低n位，如在指定class description以上，用于计算返回的值。返回的值为非预先乘法格式。
    
    重写：
    
    getRGB在类别 ColorModel
    
    参数
    
    pixel - 指定像素
    
    结果
    
    指定像素的颜色和alpha分量
    
    另请参见：
    
    ColorModel.getRGBdefault()
  - getDataElements
```
public Object getDataElements(int rgb,
                              Object pixel)
```
    返回此ColorModel中的像素的数据元素数组表示，给出了默认RGB颜色模型中的整数像素表示。然后可以将该数组传递给8838717545866对象的setDataElements方法。如果像素变量为null ，则会null一个新数组。如果pixel不是null ，它必须是类型的基本数组transferType ; 否则，抛出一个ClassCastException 。一个ArrayIndexOutOfBoundsException如果抛出pixel是不是大到足以容纳这个像素值ColorModel 。返回像素数组。
    由于IndexColorModel可以被子类化，子类继承了该方法的实现，如果它们不覆盖它，那么如果它们使用不支持的transferType，它们将抛出transferType 。
    
    重写：
    
    getDataElements在 ColorModel
    
    参数
    
    rgb - 默认RGB颜色模型中的整数像素表示
    
    pixel - 指定的像素
    
    结果
    
    该IndexColorModel中指定像素的数组 IndexColorModel 。
    
    异常
    
    ClassCastException -如果 pixel不是类型的基本数组 transferType
    
    ArrayIndexOutOfBoundsException - 如果 pixel不够大，不能持有这个 ColorModel的像素值
    
    UnsupportedOperationException - 如果 transferType无效
    
    另请参见：
    
    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)
```
    返回此ColorModel指定像素的非标准化颜色/ alpha分量ColorModel 。像素值被指定为int。如果components数组为null ，则会分配一个包含offset + getNumComponents()元素的新数组。返回components数组，只有hasAlpha返回true，才包含alpha组件。颜色/ alpha分量存储中components阵列在起动offset即使阵列由这种方法分配的。 ArrayIndexOutOfBoundsException如果components阵列不是null ，并且不够大，不能保持从offset开始的所有颜色和alpha offset 。
    
    重写：
    
    getComponents在类别 ColorModel
    
    参数
    
    pixel - 指定的像素
    
    components - 接收指定像素的颜色和alpha分量的数组
    
    offset - 偏移到 components阵列，开始存储颜色和alpha组件
    
    结果
    
    一个数组，包含从指定的偏移开始的指定像素的颜色和alpha分量。
    
    另请参见：
    
    ColorModel.hasAlpha() ， ColorModel.getNumComponents()
  - getComponents
```
public int[] getComponents(Object pixel,
                           int[] components,
                           int offset)
```
    返回此ColorModel指定像素的非标准化颜色/ alpha分量ColorModel 。像素值由作为对象引用传递的类型为transferType的数据元素的数组指定。如果pixel不是类型的基本数组transferType ，一个ClassCastException被抛出。一个ArrayIndexOutOfBoundsException如果抛出pixel是不是大到足以容纳这个像素值ColorModel 。如果components数组为null ，则会分配一个包含offset + getNumComponents()元素的新数组。 components数组将返回，只有hasAlpha返回true时，才会包含alpha组件。颜色/ alpha分量存储中components阵列在起动offset即使阵列由这种方法分配的。 ArrayIndexOutOfBoundsException也被抛出，如果components数组不是null ，并且不够大，不能容纳从offset开始的所有颜色和alpha offset 。
    由于IndexColorModel可以被子类化，子类继承了该方法的实现，如果它们不覆盖它，那么如果它们使用不支持的transferType，它们将抛出transferType 。
    
    重写：
    
    getComponents在 ColorModel
    
    参数
    
    pixel - 指定的像素
    
    components - 接收指定像素的颜色和alpha分量的数组
    
    offset - 在开始存储指定像素的颜色和alpha分量的 components数组中的索引
    
    结果
    
    一个数组，包含从指定的偏移开始的指定像素的颜色和alpha分量。
    
    异常
    
    ArrayIndexOutOfBoundsException - 如果 pixel不够大，不足以持有该 ColorModel的像素值，或者 components阵列不是 null ，并且不够大，不能保持从offset开始的所有颜色和alpha offset
    
    ClassCastException -如果 pixel不是类型的基本数组 transferType
    
    UnsupportedOperationException - 如果 transferType不是支持的传输类型之一
    
    另请参见：
    
    ColorModel.hasAlpha() ， ColorModel.getNumComponents()
  - getDataElement
```
public int getDataElement(int[] components,
                          int offset)
```
    返回表示为在此一个int的像素值ColorModel给定非标准化颜色/ alpha分量的阵列。 ArrayIndexOutOfBoundsException如果components数组不够大，不能保持从offset开始的所有颜色和alpha组件，则offset 。由于ColorModel可以被子类化，子类继承了该方法的实现，如果它们不覆盖它们，那么如果它们使用不受支持的transferType，它们将抛出异常。
    
    重写：
    
    getDataElement在类别 ColorModel
    
    参数
    
    components - 非规范化颜色和alpha组件的数组
    
    offset - 索引到 components ，开始检索颜色和alpha组件
    
    结果
    
    这个 int像素值在这个 ColorModel对应的指定组件。
    
    异常
    
    ArrayIndexOutOfBoundsException - 如果 components数组不够大，不能保持从offset开始的所有颜色和alpha offset
    
    UnsupportedOperationException - 如果 transferType无效
  - getDataElements
```
public Object getDataElements(int[] components,
                              int offset,
                              Object pixel)
```
    返回此的像素的数据元素数组表示ColorModel给定非标准化颜色/ alpha分量的阵列。然后可以将该数组传递给WritableRaster对象的setDataElements方法。 ArrayIndexOutOfBoundsException如果components数组不够大，不能容纳所有的颜色和alpha组件，从offset开始就offset 。如果像素变量为null ，则会null一个新数组。如果pixel不是null ，它必须是类型的基本数组transferType ; 否则，抛出一个ClassCastException 。一个ArrayIndexOutOfBoundsException如果pixel不是特别大，不能保存此像素值抛出ColorModel 。
    由于IndexColorModel可以被子类化，子类继承了该方法的实现，如果它们不覆盖它，那么如果他们使用不支持的transferType
    
    重写：
    
    getDataElements在 ColorModel
    
    参数
    
    components - 非规范化颜色和alpha组件的数组
    
    offset - 索引到 components开始检索颜色和alpha组件
    
    pixel -所述 Object表示颜色和alpha分量的数组
    
    结果
    
    一个 Object表示一个颜色和alpha组件的数组。
    
    异常
    
    ClassCastException -如果 pixel不是类型的基本数组 transferType
    
    ArrayIndexOutOfBoundsException -如果 pixel是不足够大以保存此像素值 ColorModel或 components阵列是没有大到足以容纳所有的颜色和alpha分量开始于 offset
    
    UnsupportedOperationException - 如果 transferType不是支持的传输类型之一
    
    另请参见：
    
    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)
```
    创建WritableRaster具有指定的宽度和高度，其具有的数据布局（ SampleModel ）与此兼容ColorModel 。此方法仅适用于每像素16位或更少位的色彩模型。
    由于IndexColorModel可以被子类化，所以支持每像素大于16位的任何子类必须覆盖此方法。
    
    重写：
    
    createCompatibleWritableRaster在 ColorModel
    
    参数
    
    w - 宽度适用于新的 WritableRaster
    
    h - 适用于新的 WritableRaster的高度
    
    结果
    
    一个具有指定宽度和高度的 WritableRaster对象。
    
    异常
    
    UnsupportedOperationException - 如果像素中的位数大于16
    
    另请参见：
    
    WritableRaster ， SampleModel
  - isCompatibleRaster
```
public boolean isCompatibleRaster(Raster raster)
```
    返回 true如果 raster与此兼容 ColorModel或 false如果不是与此兼容 ColorModel 。
    
    重写：
    
    isCompatibleRaster在类别 ColorModel
    
    参数
    
    raster - 要测试兼容性的Raster对象
    
    结果
    
    true如果raster是兼容这个ColorModel ; false否则。
  - createCompatibleSampleModel
```
public SampleModel createCompatibleSampleModel(int w,
                                               int h)
```
    创建 SampleModel具有指定的宽度和高度，具有与此兼容的数据布局 ColorModel 。
    
    重写：
    
    createCompatibleSampleModel在类别 ColorModel
    
    参数
    
    w - 要应用于新的 SampleModel的宽度
    
    h - 适用于新的 SampleModel的高度
    
    结果
    
    一个具有指定宽度和高度的 SampleModel对象。
    
    异常
    
    IllegalArgumentException - 如果 w或 h不大于0
    
    另请参见：
    
    SampleModel
  - isCompatibleSampleModel
```
public boolean isCompatibleSampleModel(SampleModel sm)
```
    检查指定的SampleModel与此兼容ColorModel 。如果sm是null ，此方法返回false 。
    
    重写：
    
    isCompatibleSampleModel在类别 ColorModel
    
    参数
    
    sm - 指定的 SampleModel或 null
    
    结果
    
    true如果SampleModel的SampleModel与此ColorModel ; false否则。
    
    另请参见：
    
    SampleModel
  - convertToIntDiscrete
```
public BufferedImage convertToIntDiscrete(Raster raster,
                                          boolean forceARGB)
```
    返回一个新的BufferedImage TYPE_INT_ARGB或TYPE_INT_RGB的具有Raster通过展开源的索引来计算的与像素数据Raster使用此的颜色/ alpha分量数组ColorModel 。源Raster中每个索引值的较低n位（如上面的class description中所指定）用于计算返回图像中的颜色/ alpha值。如果forceARGB为true ，则返回TYPE_INT_ARGB图像，无论此ColorModel是否具有Alpha组件阵列或透明像素。
    
    参数
    
    raster - 指定的 Raster
    
    forceARGB - 如果true ，返回的BufferedImage是TYPE_INT_ARGB; 否则为TYPE_INT_RGB
    
    结果
    
    一个 BufferedImage创建与指定的 Raster
    
    异常
    
    IllegalArgumentException - 如果栅格参数与此IndexColorModel不兼容
  - isValid
```
public boolean isValid(int pixel)
```
    返回像素是否有效。
    
    参数
    
    pixel - 指定的像素值
    
    结果
    
    true如果pixel有效; false否则。
    
    从以下版本开始：
    
    1.3
  - isValid
```
public boolean isValid()
```
    返回所有像素是否有效。
    
    结果
    
    true如果所有像素都有效; false否则。
    
    从以下版本开始：
    
    1.3
  - getValidPixels
```
public BigInteger getValidPixels()
```
    返回一个BigInteger ，表示色彩映射中有效/无效的像素。如果该索引处的BigInteger值被设置，则该位有效，如果该索引处的BigInteger值未设置，则该BigInteger无效。在BigInteger中查询的唯一有效范围是0和地图大小之间。
    
    结果
    
    一个 BigInteger有效/无效像素的BigInteger。
    
    从以下版本开始：
    
    1.3
  - finalize
```
public void finalize()
```
    一旦这个 ColorModel不再被 ColorModel就处理与这个 ColorModel的系统资源。
    
    重写：
    
    finalize在 ColorModel
    
    另请参见：
    
    WeakReference ， PhantomReference
  - toString
```
public String toString()
```
    返回 String这个内容表示 ColorModel对象。
    
    重写：
    
    toString在类别 ColorModel
    
    结果
    
    一个 String代表这个 ColorModel对象的内容。

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class IndexColorModel

Field Summary

Fields inherited from class java.awt.image.ColorModel

Fields inherited from interface java.awt.Transparency

构造方法摘要

方法摘要

Methods inherited from class java.awt.image.ColorModel

Methods inherited from class java.lang.Object

构造方法详细信息

IndexColorModel

IndexColorModel

IndexColorModel

IndexColorModel

IndexColorModel

IndexColorModel

IndexColorModel

方法详细信息

getTransparency

getComponentSize

getMapSize

getTransparentPixel

getReds

getGreens

getBlues

getAlphas

getRGBs

getRed

getGreen

getBlue

getAlpha

getRGB

getDataElements

getComponents

getComponents

getDataElement

getDataElements

createCompatibleWritableRaster

isCompatibleRaster

createCompatibleSampleModel

isCompatibleSampleModel

convertToIntDiscrete

isValid

isValid

getValidPixels

finalize

toString