java.awt.image

Class PackedColorModel

java.lang.Object

java.awt.image.ColorModel

java.awt.image.PackedColorModel

All Implemented Interfaces:

Transparency

已知直接子类：

DirectColorModel

public abstract class PackedColorModel
extends ColorModel

的 PackedColorModel类是一个抽象 ColorModel类作品代表颜色和alpha信息作为单独的样本像素值和包装的所有样品的单像素成一个int，短，或字节数量。这个类可以使用任意 ColorSpace。在像素值的颜色样本的数量必须在 ColorSpace颜色分量个数。可以有一个单一的α样品。数组的长度总是1的方法，使用一个阵列像素表示的类型 transferType。传输类型支持databuffer.type_byte，databuffer.type_ushort，和databuffer.type_int。颜色和alpha样本存储在比特数组的单个元素的位掩码表示。每一个位掩码必须是连续的，而掩码必须不重叠。同样的面具，适用于单像素表示通过其他方法使用int。面具和颜色/α样品对应如下：

• 面具是由指数从0到getNumComponents - 1确定。
• 第一getNumColorComponents指标参考色样。
• 如果一个字母的样本是存在的，它对应的最后一个索引。
• 色指数的顺序由ColorSpace指定。通常，这反映了颜色空间类型的名称（例如，type_rgb），指数0对应红色，指数1绿2蓝，和指数。

从像素值到颜色/α分量的显示或处理目的的翻译是一对一的样品的一对一的对应关系。一个PackedColorModel通常是用于图像数据，使用口罩定义包装的样品。例如，一个PackedColorModel可以与SinglePixelPackedSampleModel构建BufferedImage连词。通常由SampleModel和ColorModel用口罩将是相同的。然而，如果他们是不同的，像素数据的解释是根据颜色的ColorModel面具了。

一个int像素表示的是适用于所有这个类的对象，因为它总是能代表一个单一的int这类使用的像素值。因此，使用这种表示方法，不要把因无效像素值的IllegalArgumentException。

PackedColorModel DirectColorModel的子类，它类似于一个X11真彩视觉。

另请参见：

DirectColorModel， SinglePixelPackedSampleModel， BufferedImage

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
PackedColorModel(ColorSpace space, int bits, int[] colorMaskArray, int alphaMask, boolean isAlphaPremultiplied, int trans, int transferType) 构建了从彩色面具阵列 PackedColorModel，指定哪一位在 int表示每个像素包含样本颜色，和Alpha遮罩。
PackedColorModel(ColorSpace space, int bits, int rmask, int gmask, int bmask, int amask, boolean isAlphaPremultiplied, int trans, int transferType) 构建了从指定的面具，这表明位在 int像素表示含有α， PackedColorModel红色，绿色和蓝色的颜色样本。

方法摘要

Modifier and Type	Method and Description
SampleModel	createCompatibleSampleModel(int w, int h) 创建一个具有指定宽度和高度，具有数据的布局，这 ColorModel兼容 SampleModel。
boolean	equals(Object obj) 如果指定的 Object是 PackedColorModel实例和等于这 PackedColorModel。
WritableRaster	getAlphaRaster(WritableRaster raster) 返回一个 WritableRaster表示图像的alpha通道，从输入 WritableRaster提取。
int	getMask(int index) 返回表示像素中包含指定颜色/阿尔法样本的掩码。
int[]	getMasks() 返回一个掩码数组，指示在一个像素中的哪些位包含颜色和字母的样本。
boolean	isCompatibleSampleModel(SampleModel sm) 如果指定的检查 SampleModel与 ColorModel兼容。

Methods inherited from class java.awt.image.ColorModel

coerceData, createCompatibleWritableRaster, finalize, getAlpha, getAlpha, getBlue, getBlue, getColorSpace, getComponents, getComponents, getComponentSize, getComponentSize, getDataElement, getDataElement, getDataElements, getDataElements, getDataElements, getGreen, getGreen, getNormalizedComponents, getNormalizedComponents, getNumColorComponents, getNumComponents, getPixelSize, getRed, getRed, getRGB, getRGB, getRGBdefault, getTransferType, getTransparency, getUnnormalizedComponents, hasAlpha, hashCode, isAlphaPremultiplied, isCompatibleRaster, toString

Methods inherited from class java.lang.Object

clone, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

PackedColorModel

public PackedColorModel(ColorSpace space,
                        int bits,
                        int[] colorMaskArray,
                        int alphaMask,
                        boolean isAlphaPremultiplied,
                        int trans,
                        int transferType)

构建了从彩色面具阵列 PackedColorModel，指定哪一位在 int表示每个像素包含样本颜色，和Alpha遮罩。在指定的 ColorSpace颜色分量。对 colorMaskArray长度应在 ColorSpace组件的数量。所有在每个面具位必须是连续的，适合在指定数量的 int像素表示的最低有效位。如果 alphaMask是0，没有α。如果有α的 boolean isAlphaPremultiplied指定如何解释颜色和像素值α样品。如果 boolean是 true，色样的假设已乘以α样品。的透明度， trans，指定α值可以通过这种颜色模型来表示。传输类型是用于表示像素值的原始数组的类型。

参数

space -指定 ColorSpace

bits在像素值的比特数

colorMaskArray数组指定代表，代表颜色分量的像素值的比特的面具

alphaMask -指定代表代表alpha分量的像素值的位掩码

isAlphaPremultiplied - true如果颜色样品预乘alpha样品； false否则

trans指定alpha值，可以通过这个颜色模型来表示

transferType -用来表示像素值的数组类型

异常

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

PackedColorModel

public PackedColorModel(ColorSpace space,
                        int bits,
                        int rmask,
                        int gmask,
                        int bmask,
                        int amask,
                        boolean isAlphaPremultiplied,
                        int trans,
                        int transferType)

构建了从指定的面具，这表明位在 int像素表示含有α， PackedColorModel红色，绿色和蓝色的颜色样本。颜色分量是在指定的 ColorSpace，必须colorspace.type_rgb型。所有在每个面具位必须是连续的，适合在指定数量的 int像素表示的最低有效位。如果 amask是0，没有α。如果有α的 boolean isAlphaPremultiplied指定如何解释颜色和像素值α样品。如果 boolean是 true，色样的假设已乘以α样品。的透明度， trans，指定α值可以通过这种颜色模型来表示。传输类型是用于表示像素值的原始数组的类型。

参数

space -指定 ColorSpace

bits在像素值的比特数

rmask -指定代表，代表红颜色分量的像素值的位掩码

gmask -指定代表，代表着绿色的颜色分量的像素值的位掩码

bmask -指定代表，代表蓝颜色分量的像素值的位掩码

amask -指定代表代表alpha分量的像素值的位掩码

isAlphaPremultiplied - true如果颜色样品预乘alpha样品； false否则

trans指定alpha值，可以通过这个颜色模型来表示

transferType -用来表示像素值的数组类型

异常

IllegalArgumentException -如果 space不是type_rgb空间

另请参见：

ColorSpace

方法详细信息

getMask

public final int getMask(int index)

返回表示像素中包含指定颜色/阿尔法样本的掩码。颜色样品， index对应颜色样品名称颜色空间中的位置。因此，一个 index等于0个CMYK颜色空间对应的是青色和 index等于1对应于品红。如果有α，α index会：

alphaindex = numcomponents() - 1；

参数

index -指定颜色或α样品

结果

面具，这表明该位的 int像素表示包含指定的颜色或α index样本。

异常

ArrayIndexOutOfBoundsException -如果 index大于这个 PackedColorModel组件数减去1或者 index小于零

getMasks

public final int[] getMasks()

返回一个掩码数组，指示在一个像素中的哪些位包含颜色和字母的样本。

结果

面具的阵列，这表明该位的 int像素表示包含颜色或α样品。

createCompatibleSampleModel

public SampleModel createCompatibleSampleModel(int w,
                                               int h)

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

重写：

createCompatibleSampleModel 方法重写，继承类 ColorModel

参数

w的宽度（像素）的图像数据描述的区域

h -高度（像素）的图像数据的区域描述

结果

新创建的 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

getAlphaRaster

public WritableRaster getAlphaRaster(WritableRaster raster)

返回一个 WritableRaster表示图像的alpha通道，从输入 WritableRaster提取。这种方法假设 WritableRaster对象这 ColorModel店α波段，相关如果存在，作为图像数据的最后一个乐队。返回 null如果没有独立空间的alpha通道这 ColorModel相关。此方法创建一个新的 WritableRaster，但股价数据阵列。

重写：

getAlphaRaster 方法重写，继承类 ColorModel

参数

raster - WritableRaster含有图像

结果

一个 WritableRaster表示包含在 raster图像的alpha通道。

equals

public boolean equals(Object obj)

如果指定的 Object是 PackedColorModel实例和等于这 PackedColorModel。

重写：

equals 方法重写，继承类 ColorModel

参数

obj - Object测试平等

结果

true如果指定 Object是 PackedColorModel实例和等于这 PackedColorModel； false否则。

另请参见：

Object.hashCode()， HashMap