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

的 IndexColorModel类是一个 ColorModel类作品与像素值组成的一个样本，是一个指数为默认的sRGB色彩空间的一个固定的调色板。色彩映射指定红，绿，蓝，和可选的alpha分量对应的指数。所有组件都在色度图表示为8位无符号整数的值。一些构造函数允许调用者指定”中的指示信息条目信息有效和代表不可用的颜色通过设置在一个 BigInteger对象的位洞”。这种颜色模型类似于一个X11彩色视觉。

一些建设者提供了一个方法来指定在色度图每个像素的alpha分量，而其他人要么不提供这样的手段，或者，在某些情况下，一个标志，指示信息数据包含alpha值。如果没有提供给构造函数，一个不透明的α组分（α= 1）被假定为每个条目。可以提供一个可选的透明像素值，该值指示将要完全透明的像素，无论提供或假定该像素值的任何α分量。注意，在一个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）假和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，数组的长度是。传输类型支持DataBuffer.TYPE_BYTE和DataBuffer.TYPE_USHORT。一个整数像素表示的是有效的这个类的所有对象，因为它总是能代表一个int，因此这类使用的像素值，使用这种表示不把因无效像素值的IllegalArgumentException。

这个类中的许多方法都是最终的。这的原因是，底层的原生图形代码对这个类的布局和操作的假设和这些假设反映在这里的方法的实现，是标记的最终。您可以子类的子类为其他原因，但不能重写或修改这些方法的行为。

另请参见：

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) 构建了一个 IndexColorModel从数组对象的每个整数是由红，绿，蓝，和默认的RGB颜色模型格式可选的alpha分量。
IndexColorModel(int bits, int size, int[] cmap, int start, int transferType, BigInteger validBits) 构建了一个 IndexColorModel从 int数组中的每个 int是由红，绿，蓝，和默认的RGB颜色模型格式的alpha分量。

方法摘要

Modifier and Type	Method and Description
BufferedImage	convertToIntDiscrete(Raster raster, boolean forceARGB) 返回一个新的type_int_argb或type_int_rgb具有像素数据通过扩大指标使用颜色/α这 ColorModel组件阵列在源 Raster计算 Raster BufferedImage。
SampleModel	createCompatibleSampleModel(int w, int h) 创建一个具有指定宽度和高度，具有数据的布局，这 ColorModel兼容 SampleModel。
WritableRaster	createCompatibleWritableRaster(int w, int h) 创建一个具有指定宽度和高度，具有数据布局 WritableRaster（ SampleModel）这 ColorModel兼容。
void	finalize() 配置系统资源，这 ColorModel相关这一 ColorModel不再被引用。
int	getAlpha(int pixel) 返回指定像素的阿尔法组件，缩放比例从0到255。
void	getAlphas(byte[] a) 将阿尔法透明组件数组复制到指定的数组中。
int	getBlue(int pixel) 返回为指定像素的蓝色成分，比例从0到255在默认的RGB颜色空间，sRGB。
void	getBlues(byte[] b) 将蓝色的数组数组复制到指定的数组中。
int[]	getComponents(int pixel, int[] components, int offset) 返回一个数组的非标准化的颜色/α在这 ColorModel指定像素分量。
int[]	getComponents(Object pixel, int[] components, int offset) 返回一个数组的非标准化的颜色/α在这 ColorModel指定像素分量。
int[]	getComponentSize() 返回每个颜色/α分量的比特数的数组。
int	getDataElement(int[] components, int offset) 返回一个像素值表示为在这 ColorModel int数组化了颜色和alpha分量。
Object	getDataElements(int[] components, int offset, Object pixel) 返回一个在这 ColorModel像素数据元素的数组表示给定一个数组的非标准化的颜色/ alpha分量。
Object	getDataElements(int rgb, Object pixel) 返回一个在这要一个像素数据元素的数组表示，鉴于在默认的RGB颜色模型的整数像素表示。
int	getGreen(int pixel) 返回指定像素的绿色成分，比例从0到255在默认的RGB颜色空间，sRGB。
void	getGreens(byte[] g) 将绿色颜色分量数组复制到指定的数组中。
int	getMapSize() 返回的颜色/α在这 IndexColorModel组件阵列的大小。
int	getRed(int pixel) 返回为指定像素的红色分量，比例从0到255在默认的RGB颜色空间，sRGB。
void	getReds(byte[] r) 将红色的颜色分量数组复制到指定的数组中。
int	getRGB(int pixel) 返回在默认的RGB颜色模型格式的像素的颜色和alpha分量。
void	getRGBs(int[] rgb) 转换数据为每个指标从颜色和alpha分量数组int在默认的RGB色彩模型格式复制产生的32位ARGB值到指定的数组。
int	getTransparency() 返回透明度。
int	getTransparentPixel() 返回在这 IndexColorModel或透明像素指数1如果有0的α值没有像素。
BigInteger	getValidPixels() 返回一个 BigInteger表明无效有效像素的色度。
boolean	isCompatibleRaster(Raster raster) 返回 true如果它不是这个 ColorModel兼容 raster与 ColorModel或 false兼容。
boolean	isCompatibleSampleModel(SampleModel sm) 如果指定的检查 SampleModel与 ColorModel兼容。
boolean	isValid() 返回是否所有的像素都是有效的。
boolean	isValid(int pixel) 返回是否像素是否有效。
String	toString() 返回该 ColorModelobject内容 String表示。

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

Constructor Detail

IndexColorModel

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

构建了从红、绿 IndexColorModel指定的数组，和蓝色分量。像素描述此颜色模式都有255的alpha分量的非标准化（1 归一化），这意味着他们是完全不透明的。指定颜色组件的所有数组必须至少有指定的条目号。的 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的alpha分量的非标准化（1 归一化），这意味着他们是完全不透明的，除了显示像素是透明的。指定颜色组件的所有数组必须至少有指定的条目号。的 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 -α值组成的数组

异常

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指示是α值包含在 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分量。指定的透明索引表示一个完全透明的像素，而不管它指定的任何一个字母值。数组必须有足够的值来填充指定大小的所有所需的组件数组。的 ColorSpace是默认的sRGB空间。透明度的值可以是任何 Transparency.OPAQUE， Transparency.BITMASK，或 Transparency.TRANSLUCENT取决于参数，如在 class description以上指定。转移型是最小的 DataBuffer.TYPE_BYTE或 DataBuffer.TYPE_USHORT可以容纳一个像素。

参数

bits -每个像素占用的比特数

size -颜色分量的数组的大小

cmap -颜色分量数组

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

hasalpha指示是α值包含在 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)

构建了一个 IndexColorModel从数组对象的每个整数是由红，绿，蓝，和默认的RGB颜色模型格式可选的alpha分量。指定的透明索引表示一个完全透明的像素，而不管它指定的任何一个字母值。数组必须有足够的值来填充指定大小的所有所需的组件数组。的 ColorSpace是默认的sRGB空间。透明度的值可以是任何 Transparency.OPAQUE， Transparency.BITMASK，或 Transparency.TRANSLUCENT取决于参数，指定的 class description以上。

参数

bits -每个像素占用的比特数

size -颜色分量的数组的大小

cmap -颜色分量数组

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

hasalpha指示是α值包含在 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.OPAQUE， Transparency.BITMASK，或 Transparency.TRANSLUCENT取决于参数，如在 class description以上指定。传输类型必须是一个 DataBuffer.TYPE_BYTE DataBuffer.TYPE_USHORT。的 BigInteger对象指定在 cmap阵列无效有效像素。如果在指数的 BigInteger值设置一个像素是有效的，如果不设置指标 BigInteger位无效。

参数

bits -每个像素占用的比特数

size -颜色分量的数组的大小

cmap -颜色分量数组

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

transferType -指定的数据类型

validBits - BigInteger对象。如果一位设置在BigInteger，在指标的像素是有效的。如果没有设置位，则该索引中的像素被认为是无效的。如果为空，所有像素都是有效的。被认为只有从0到Map大小的位。

异常

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

IllegalArgumentException -如果 size小于1

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

从以下版本开始：

一点三

方法详细信息

getTransparency

public int getTransparency()

返回透明度。返回的位掩码，不透明或半透明

Specified by:

getTransparency 接口 Transparency

重写：

getTransparency 方法重写，继承类 ColorModel

结果

这 IndexColorModel透明度

另请参见：

Transparency.OPAQUE， Transparency.BITMASK， Transparency.TRANSLUCENT

getComponentSize

public int[] getComponentSize()

返回每个颜色/α分量的比特数的数组。数组中包含的颜色分量依次为红色、绿色、蓝色，其次是阿尔法分量，如果存在。

重写：

getComponentSize 方法重写，继承类 ColorModel

结果

一个数组包含的每种颜色的alpha分量，这 IndexColorModel比特数

getMapSize

public final int getMapSize()

返回的颜色/α在这 IndexColorModel组件阵列的大小。

结果

颜色和阿尔法组件数组的大小。

getTransparentPixel

public final int getTransparentPixel()

返回在这 IndexColorModel或透明像素指数1如果有0的α值没有像素。如果一个透明的像素被明确指定在一个构造函数由它的索引，那么该索引将是首选，否则，任何一个像素的索引是完全透明的，可能会返回。

结果

在这 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)

将阿尔法透明组件数组复制到指定的数组中。只有数组的指定的 getMapSize初始条目编写。

参数

a -指定的数组，数组的元素α组件复制

getRGBs

public final void getRGBs(int[] rgb)

转换数据为每个指标从颜色和alpha分量数组int在默认的RGB色彩模型格式复制产生的32位ARGB值到指定的数组。只有数组的指定的 getMapSize初始条目编写。

参数

rgb -指定的数组，这个数组转换ARGB值从颜色和alpha组件复制。

getRed

public final int getRed(int pixel)

返回为指定像素的红色分量，比例从0到255在默认的RGB颜色空间，sRGB。像素值指定为int，只有较低的N位的像素值，在 class description以上指定的，是用来计算返回值。返回的值是一个非预乘的值。

Specified by:

getRed 方法重写，继承类 ColorModel

参数

pixel -指定像素

结果

指定像素的红色分量的值

getGreen

public final int getGreen(int pixel)

返回指定像素的绿色成分，比例从0到255在默认的RGB颜色空间，sRGB。像素值指定为int，只有较低的N位的像素值，在 class description以上指定的，是用来计算返回值。返回的值是一个非预乘的值。

Specified by:

getGreen 方法重写，继承类 ColorModel

参数

pixel -指定像素

结果

指定像素的绿色颜色分量的值

getBlue

public final int getBlue(int pixel)

返回为指定像素的蓝色成分，比例从0到255在默认的RGB颜色空间，sRGB。像素值指定为int，只有较低的N位的像素值，在 class description以上指定的，是用来计算返回值。返回的值是一个非预乘的值。

Specified by:

getBlue 方法重写，继承类 ColorModel

参数

pixel -指定像素

结果

指定像素的蓝色分量的值

getAlpha

public final int getAlpha(int pixel)

返回指定像素的阿尔法组件，缩放比例从0到255。像素值指定为int，只有较低的N位的像素值，在 class description以上指定的，是用来计算返回值。

Specified by:

getAlpha 方法重写，继承类 ColorModel

参数

pixel -指定像素

结果

指定像素的α分量的值

getRGB

public final int getRGB(int pixel)

返回在默认的RGB颜色模型格式的像素的颜色和alpha分量。像素值指定为int，只有较低的N位的像素值，在 class description以上指定的，是用来计算返回值。返回的值是在一个非预乘以格式。

重写：

getRGB 方法重写，继承类 ColorModel

参数

pixel -指定像素

结果

指定像素的颜色和α分量

另请参见：

ColorModel.getRGBdefault()

getDataElements

public Object getDataElements(int rgb,
                              Object pixel)

返回一个在这要一个像素数据元素的数组表示，鉴于在默认的RGB颜色模型的整数像素表示。那么这个阵列可以通过一个 WritableRaster对象的 setDataElements方法。如果像素变为 null，创建一个新数组。如果 pixel不 null，它必须是一个原始的数组类型 transferType；否则，一个 ClassCastException抛出。如果一个 ArrayIndexOutOfBoundsException pixel不足以容纳这 ColorModel像素值扔。返回像素数组。

因为IndexColorModel可以子类，子类继承这个方法的实现，如果不推翻它，然后抛出一个异常，如果他们使用的是不支持的transferType。

重写：

getDataElements 方法重写，继承类 ColorModel

参数

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

pixel -指定像素

结果

在这 IndexColorModel指定像素数组表示。

异常

ClassCastException -如果 pixel不是原始的数组类型 transferType

如果 pixel ArrayIndexOutOfBoundsException不足以容纳这 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指定像素分量。像素值指定为int，如果 components阵列 null，创建一个新数组元素包含 offset + getNumComponents()。返回的 components阵列，与阿尔法组件包括只有 hasAlpha返回true。颜色/ alpha分量存储在 components阵列从 offset即使阵列是采用这种方法分配。一个 ArrayIndexOutOfBoundsException抛出如果 components数组不 null不足以容纳所有的颜色和alpha组件开始 offset。

重写：

getComponents 方法重写，继承类 ColorModel

参数

pixel -指定像素

components -阵列接收的颜色和指定像素的alpha分量

offset的偏移， components阵列开始存储颜色和alpha分量

结果

包含指定偏移量的指定像素的颜色和α分量的数组。

另请参见：

ColorModel.hasAlpha()， ColorModel.getNumComponents()

getComponents

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

返回一个数组的非标准化的颜色/α在这 ColorModel指定像素分量。像素值是由 transferType型通过为一个对象引用的数据元素的数组指定。如果 pixel不是原始的数组类型 transferType，一 ClassCastException抛出。如果一个 ArrayIndexOutOfBoundsException pixel不足以容纳这 ColorModel像素值扔。如果 components阵列 null，创建一个新数组元素包含 offset + getNumComponents()。返回的 components阵列，与阿尔法组件包括只有 hasAlpha返回true。颜色/ alpha分量存储在 components阵列从 offset即使阵列是采用这种方法分配。一个 ArrayIndexOutOfBoundsException也抛出如果 components数组不 null不足以容纳所有的颜色和alpha组件开始 offset。

因为IndexColorModel可以子类，子类继承这个方法的实现，如果不推翻它，然后抛出一个异常，如果他们使用的是不支持的transferType。

重写：

getComponents 方法重写，继承类 ColorModel

参数

pixel -指定像素

components -阵列接收的颜色和指定像素的alpha分量

offset的索引， components阵列开始存储颜色和指定像素的alpha分量

结果

包含指定偏移量的指定像素的颜色和α分量的数组。

异常

如果 pixel ArrayIndexOutOfBoundsException不足以容纳的像素值，这 ColorModel或者 components数组不 null不足以容纳所有的颜色和alpha组件开始 offset

ClassCastException -如果 pixel不是原始的数组类型 transferType

UnsupportedOperationException -如果 transferType是不受支持的传输类型

另请参见：

ColorModel.hasAlpha()， ColorModel.getNumComponents()

getDataElement

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

返回一个像素值表示为在这 ColorModel int数组化了颜色和alpha分量。一个 ArrayIndexOutOfBoundsException抛出如果 components阵列不足以容纳所有的颜色和alpha组件开始 offset。因为 ColorModel可以子类，子类继承这个方法的实现，如果不推翻它，然后抛出一个异常，如果他们使用的是不支持的transfertype。

重写：

getDataElement 方法重写，继承类 ColorModel

参数

components -一系列化的颜色和alpha分量

offset -指数为 components，开始检索颜色和alpha分量

结果

在这 ColorModel对应于指定组件的 int像素值。

异常

ArrayIndexOutOfBoundsException -如果 components阵列不足以容纳所有的颜色和alpha组件开始 offset

UnsupportedOperationException -如果 transferType无效

getDataElements

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

返回一个在这 ColorModel像素数据元素的数组表示给定一个数组的非标准化的颜色/ alpha分量。那么这个阵列可以通过一个 WritableRaster对象的 setDataElements方法。一个 ArrayIndexOutOfBoundsException抛出如果 components阵列不足以容纳所有的颜色和alpha组件开始 offset。如果像素变为 null，创建一个新数组。如果 pixel不 null，它必须是一个原始的数组类型 transferType；否则，一个 ClassCastException抛出。如果一个 ArrayIndexOutOfBoundsException像素不足以容纳这 ColorModel像素值扔。

因为IndexColorModel可以子类，子类继承这个方法的实现，如果不推翻它，然后抛出一个异常，如果他们使用的是不支持的transferType

重写：

getDataElements 方法重写，继承类 ColorModel

参数

components -一系列化的颜色和alpha分量

offset -指数为 components，开始检索颜色和alpha分量

pixel - Object数组表示的颜色和alpha分量

结果

一个 Object数组表示的颜色和alpha分量。

异常

ClassCastException -如果 pixel不是原始的数组类型 transferType

如果 pixel ArrayIndexOutOfBoundsException不足以容纳这 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如果它不是这个 ColorModel兼容 raster与 ColorModel或 false兼容。

重写：

isCompatibleRaster 方法重写，继承类 ColorModel

参数

raster -兼容性测试的 Raster对象

结果

true如果 raster与 ColorModel兼容； false否则。

createCompatibleSampleModel

public SampleModel createCompatibleSampleModel(int w,
                                               int h)

创建一个具有指定宽度和高度，具有数据的布局，这 ColorModel兼容 SampleModel。

重写：

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与 ColorModel兼容； false否则。

另请参见：

SampleModel

convertToIntDiscrete

public BufferedImage convertToIntDiscrete(Raster raster,
                                          boolean forceARGB)

返回一个新的type_int_argb或type_int_rgb具有像素数据通过扩大指标使用颜色/α这 ColorModel组件阵列在源 Raster计算 Raster BufferedImage。只有较低的N位各指标值的源 Raster，在 class description以上指定的，被用来计算返回的图像的颜色/α值。如果 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否则。

从以下版本开始：

一点三

isValid

public boolean isValid()

返回是否所有的像素都是有效的。

结果

true如果所有像素都是有效的； false否则。

从以下版本开始：

一点三

getValidPixels

public BigInteger getValidPixels()

返回一个 BigInteger表明无效有效像素的色度。如果在指数的 BigInteger值设置点是有效的，如果不设置指标 BigInteger值无效。在 BigInteger查询唯一有效的范围是0和图的大小之间。

结果

一个 BigInteger指示无效的有效像素。

从以下版本开始：

一点三

finalize

public void finalize()

配置系统资源，这 ColorModel相关这一 ColorModel不再被引用。

重写：

finalize 方法重写，继承类 ColorModel

另请参见：

WeakReference， PhantomReference

toString

public String toString()

返回该 ColorModelobject内容 String表示。

重写：

toString 方法重写，继承类 ColorModel

结果

一个 String表示此 ColorModel对象的内容。