Java java.awt.image 类 IndexColorModel（JDK5）

所有类

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 对象中的位集指示哪些项是有效的，以及哪些项表示不可用的颜色。此颜色模型与 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。

由像素值表示的索引存储在传递给此类方法的像素表示形式的最低有效 n 位中，其中 n 是为特定 IndexColorModel 对象的构造方法所定义的像素大小；n 必须在 1 到 16（包括）之间。假定像素表示形式中的高位为零。对于那些使用 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 之一

getTransparency

public int getTransparency()

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

指定者：

接口 Transparency 中的 getTransparency

覆盖：

类 ColorModel 中的 getTransparency

返回：

此 IndexColorModel 的透明度值

另请参见：

Transparency.OPAQUE, Transparency.BITMASK, Transparency.TRANSLUCENT