java.awt.image
类 IndexColorModel

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

所有已实现的接口：

Transparency

public class IndexColorModel
     

      extends 
      ColorModel
     

IndexColorModel 类是一个 ColorModel 类，它使用由单个样本组成的像素值，这些像素值是默认 sRGB 颜色空间中固定 colormap 中的索引。colormap 指定了对应于每个索引的红色、绿色、蓝色和可选的 alpha 分量。在 colormap 中，所有分量都以 8 位无符号整数值表示。某些构造方法允许调用者在 colormap 中指定“空洞”：通过 BigInteger 对象中的位集指示哪些 colormap 项是有效的，以及哪些项表示不可用的颜色。此颜色模型与 X11 PseudoColor 可视化模型类似。

某些构造方法还提供了为 colormap 中的每个像素指定 alpha 分量的方法，而其他构造方法则要么不提供这种方法，要么在某些情况中使用一个标志来指示 colormap 数据是否包含 alpha 值。如果未向构造方法提供 alpha 值，则将为每个条目假定一个不透明的 alpha 分量 (alpha = 1.0)。无论为像素值提供或假定使用何种 alpha 分量，都可以提供一个指示该像素完全透明的可选透明像素值。注意，IndexColorModel 对象 colormap 中的颜色分量不会预乘 alpha 分量。

确定 IndexColorModel 对象透明度的方式如下：检查 colormap 中各颜色的 alpha 分量，并在考虑可选的 alpha 值和所有指定的透明索引后选择最具体的值。只有在 colormap 中的所有有效颜色都为不透明，并且不存在有效的透明像素时，透明度值才为 Transparency.OPAQUE。如果 colormap 中的所有有效颜色要么是完全不透明的 (alpha = 1.0)，要么是完全透明的 (alpha = 0.0)（通常在指定了有效透明像素时出现该情况），则透明值为 Transparency.BITMASK。否则透明值将为 Transparency.TRANSLUCENT，指示有效颜色具有的 alpha 分量既不是完全透明的，也不是完全不透明的 (0.0 < alpha < 1.0)。

如果 IndexColorModel 对象的透明值是 Transparency.OPAQUE，则 hasAlpha 和 getNumComponents 方法（均继承自 ColorModel）分别返回 false 和 3。对于所有其他透明度值，hasAlpha 返回 true，getNumComponents 返回 4。

用于 colormap 中索引的那些值取自像素表示形式的最低有效 n 位，其中 n 基于构造方法中指定的像素大小。对于小于 8 位的像素大小，n 向上舍入为 2 的次幂（3 变为 4，5、6 和 7 则变为 8）。对于介于 8 和 16 位之间的像素大小，n 就等于像素大小。大于 16 位的像素大小不受此类的支持。在像素表示形式中，超过 n 的高位字节将被忽略。大于或等于映射大小、但小于 2ⁿ 的索引值是未定义的，并对所有颜色和 alpha 组件返回 0。

对于那些使用 transferType 类型基本数组像素表示形式的方法，数组的长度总是一。支持的传输类型有 DataBuffer.TYPE_BYTE 和 DataBuffer.TYPE_USHORT。因为总是能以单个 int 值表示此类使用的像素值，所以单个 int 像素表示形式对于此类的所有对象都是有效的。因此，使用这种表示形式的方法不会因无效的像素值而抛出 IllegalArgumentException。

此类中的很多方法都声明为 final。这样做的原因是底层本机图形代码做出了有关布局和此类操作的假设，并且这些假设反映在标记为 final 的方法实现中。用户可以出于其他原因子类化此类，但是无法重写或修改这些方法的行为。

另请参见：

ColorModel, ColorSpace, DataBuffer

IndexColorModel

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

根据指定的红色、绿色和蓝色分量数组构造一个 IndexColorModel。此颜色模型所描述的像素都具有非标准化的 255（标准化是 1.0）alpha 分量，这意味着这些像素是完全不透明的。所有指定颜色分量的数组都必须至少具有指定的条目数。 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）alpha 分量，这意味着这些像素是完全不透明的，但指示呈现为透明的像素除外。所有指定颜色分量的数组都必须至少具有指定的条目数。 ColorSpace 是默认的 sRGB 空间。根据参数的不同，透明度值可能是 Transparency.OPAQUE 或 Transparency.BITMASK，正如上文 类描述中所指定的。传输类型是能够保存单个像素的 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)

根据给定的红色、绿色、蓝色和 alpha 分量数组构造一个 IndexColorModel。所有指定分量的数组都必须至少具有指定的条目数。 ColorSpace 是默认的 sRGB 空间。根据参数的不同，透明度值可能是 Transparency.OPAQUE、 Transparency.BITMASK 或 Transparency.TRANSLUCENT，正如上文 类描述中所指定的。传输类型是能够保存单个像素的 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)

根据交错存取红色、绿色、蓝色和可选 alpha 分量的单个数组构造一个 IndexColorModel。该数组中必须具有足够的值，以填充具有指定大小的所有所需分量数组。 ColorSpace 是默认的 sRGB 空间。根据参数的不同，透明度值可能是 Transparency.OPAQUE、 Transparency.BITMASK 或 Transparency.TRANSLUCENT，正如上文 类描述中所指定的。传输类型是能够保存单个像素的 DataBuffer.TYPE_BYTE 或 DataBuffer.TYPE_USHORT 的最小值。

参数：

bits - 每个像素占用的位数

size - 颜色分量数组的大小

cmap - 颜色分量数组

start - 第一个颜色分量的起始偏移量

hasalpha - 指示 cmap 数组中是否包含 alpha 值

抛出：

IllegalArgumentException - 如果 bits 小于 1 或大于 16

IllegalArgumentException - 如果 size 小于 1

IndexColorModel

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

根据交错存取红色、绿色、蓝色和可选 alpha 分量的单个数组构造一个 IndexColorModel。指定的透明索引表示完全透明的像素，无论为其指定的 alpha 值是什么。该数组中必须具有足够的值，以填充具有指定大小的所有所需分量数组。 ColorSpace 是默认的 sRGB 空间。根据参数的不同，透明度值可能是 Transparency.OPAQUE、 Transparency.BITMASK 或 Transparency.TRANSLUCENT，正如上文 类描述中所指定的。传输类型是能够保存单个像素的 DataBuffer.TYPE_BYTE 或 DataBuffer.TYPE_USHORT 的最小值。

参数：

bits - 每个像素占用的位数

size - 颜色分量数组的大小

cmap - 颜色分量数组

start - 第一个颜色分量的起始偏移量

hasalpha - 指示 cmap 数组中是否包含 alpha 值

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，正如上文 类描述中所指定的。

参数：

bits - 每个像素占用的位数

size - 颜色分量数组的大小

cmap - 颜色分量数组

start - 第一个颜色分量的起始偏移量

hasalpha - 指示 cmap 数组中是否包含 alpha 值

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)

根据一个 int 数组构造一个 IndexColorModel，该数组中的每个 int 值都由默认 RGB 颜色模型格式的红色、绿色、蓝色和 alpha 分量构成。该数组中必须具有足够的值，以填充具有指定大小的所有所需分量数组。 ColorSpace 是默认的 sRGB 空间。根据参数的不同，透明度值可能是 Transparency.OPAQUE、 Transparency.BITMASK 或 Transparency.TRANSLUCENT，正如上文 类描述中所指定的。该数据类型必须是 DataBuffer.TYPE_BYTE 或 DataBuffer.TYPE_USHORT 之一。 BigInteger 对象指定了 cmap 数组中的有效/无效像素。如果设置了某个索引处的 BigInteger 值，则该像素是有效的；如果未设置该索引处的 BigInteger 位，则该像素是无效的。

参数：

bits - 每个像素占用的位数

size - 颜色分量数组的大小

cmap - 颜色分量数组

start - 第一个颜色分量的起始偏移量

transferType - 指定的数据类型

validBits - 一个 BigInteger 对象。如果设置了 BigInteger 中的某个位，则该索引处的像素是有效的。如果未设置该位，则认为该索引处的像素无效。如果为 null，则所有像素都是有效的。只考虑从 0 到 colormap 大小的所有位。

抛出：

IllegalArgumentException - 如果 bits 小于 1 或大于 16

IllegalArgumentException - 如果 size 小于 1

IllegalArgumentException - 如果 transferType 不是 DataBuffer.TYPE_BYTE 或 DataBuffer.TYPE_USHORT 之一

从以下版本开始：

1.3

getTransparency

public int getTransparency()

返回透明度。返回 OPAQUE、BITMASK 或 TRANSLUCENT

指定者：

接口 Transparency 中的 getTransparency

覆盖：

类 ColorModel 中的 getTransparency

返回：

此 IndexColorModel 的透明度值

另请参见：

Transparency.OPAQUE, Transparency.BITMASK, Transparency.TRANSLUCENT

getComponentSize

public int[] getComponentSize()

返回包含各个颜色/alpha 分量位数的数组。该数组包含颜色分量的顺序是红色、绿色、蓝色，最后是 alpha 分量（如果存在）。

覆盖：

类 ColorModel 中的 getComponentSize

返回：

包含此 IndexColorModel 的各个颜色和 alpha 分量位数的数组

getMapSize

public final int getMapSize()

返回此 IndexColorModel 中颜色/alpha 分量数组的大小。

返回：

颜色和 alpha 分量数组的大小。

getTransparentPixel

public final int getTransparentPixel()

返回此 IndexColorModel 中透明像素的索引；如果没有 alpha 值为 0 的像素，则返回 -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 位用于计算返回的值，正如上文 类描述中所指定的。返回值是一个未预乘的值。

指定者：

类 ColorModel 中的 getRed

参数：

pixel - 指定的像素

返回：

指定像素的红色分量值

getGreen

public final int getGreen(int pixel)

返回指定像素的绿色分量，在默认的 RGB ColorSpace (sRGB) 中为 0 到 255。该像素值指定为 int 值。只有像素值的较低 n 位用于计算返回的值，正如上文 类描述中所指定的。返回值是一个未预乘的值。

指定者：

类 ColorModel 中的 getGreen

参数：

pixel - 指定的像素

返回：

指定像素的绿色分量值

getBlue

public final int getBlue(int pixel)

返回指定像素的蓝色分量，在默认的 RGB ColorSpace (sRGB) 中为 0 到 255。该像素值指定为 int 值。只有像素值的较低 n 位用于计算返回的值，正如上文 类描述中所指定的。返回值是一个未预乘的值。

指定者：

类 ColorModel 中的 getBlue

参数：

pixel - 指定的像素

返回：

指定像素的蓝色分量值

getAlpha

public final int getAlpha(int pixel)

返回指定像素的 alpha 分量，该值为 0 到 255。该像素值指定为 int 值。只有像素值的较低 n 位用于计算返回的值，正如上文 类描述中所指定的。

指定者：

类 ColorModel 中的 getAlpha

参数：

pixel - 指定的像素

返回：

指定像素的 alpha 分量值

getRGB

public final int getRGB(int pixel)

以默认 RGB 颜色模型格式返回像素的颜色/alpha 分量。该像素值指定为 int 值。只有像素值的较低 n 位用于计算返回的值，正如上文 类描述中所指定的。返回值是一个未预乘格式的值。

覆盖：

类 ColorModel 中的 getRGB

参数：

pixel - 指定的像素

返回：

指定像素的颜色和 alpha 分量

另请参见：

ColorModel.getRGBdefault()

getDataElements

public Object getDataElements(int rgb,
                              Object pixel)

根据默认 RGB 颜色模型中的整数像素表示形式，返回此 ColorModel 中像素的数据元素数组表示形式。然后可将此数组传递到 WritableRaster 对象的 setDataElements 方法。如果 pixel 变量为 null，则分配一个新数组。如果 pixel 不为 null，则它必须是一个 transferType 类型的基本数组；否则抛出 ClassCastException。如果 pixel 不足以保存此 ColorModel 的一个像素值，则抛出 ArrayIndexOutOfBoundsException。返回 pixel 数组。

因为可以子类化 IndexColorModel，所以子类继承此方法的实现，如果不重写子类，则在使用不受支持的 transferType 时将抛出异常。

覆盖：

类 ColorModel 中的 getDataElements

参数：

rgb - 默认 RGB 颜色模型中的整数像素表示形式

pixel - 指定的像素

返回：

表示此 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 分量数组。该像素值指定为 int 值。如果 components 数组为 null，则分配一个包含 offset + getNumComponents() 个元素的新数组。返回 components 数组，仅在 hasAlpha 返回 true 时，该数组才包括 alpha 分量。即使从 offset 开始的 components 数组是由此方法所分配的，颜色/alpha 分量也将存储在该数组中。如果 components 数组不为 null 并且大小不足以保存从 offset 处开始的所有颜色和 alpha 分量，则抛出 ArrayIndexOutOfBoundsException。

覆盖：

类 ColorModel 中的 getComponents

参数：

pixel - 指定的像素

components - 接收指定像素的颜色和 alpha 分量的数组

offset - components 数组中的偏移量，从此处开始存储颜色和 alpha 分量

返回：

包含从指定偏移量处开始的指定像素的颜色和 alpha 分量的数组。

另请参见：

ColorModel.hasAlpha(), ColorModel.getNumComponents()

getComponents

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

返回此 ColorModel 中指定像素的非标准化颜色/alpha 分量数组。像素值由作为对象引用传入的 transferType 类型的数据元素数组指定。如果 pixel 不是 transferType 类型的基本数组，则抛出 ClassCastException。如果 pixel 大小不足以保存此 ColorModel 的一个像素值，则抛出