|
JavaTM Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
java.lang.Object javax.imageio.ImageTypeSpecifier
public class ImageTypeSpecifier
允许以便捷方式指定图像格式(尤其是其 SampleModel
和 ColorModel
)的类。
字段摘要 | |
---|---|
protected ColorModel |
colorModel
将用作原型的 ColorModel 。 |
protected SampleModel |
sampleModel
将用作原型的 SampleModel 。 |
构造方法摘要 | |
---|---|
ImageTypeSpecifier(ColorModel colorModel,
SampleModel sampleModel)
直接根据 ColorModel 和 SampleModel 构造一个 ImageTypeSpecifier 。 |
|
ImageTypeSpecifier(RenderedImage image)
根据 RenderedImage 构造一个 ImageTypeSpecifier 。 |
方法摘要 | |
---|---|
static ImageTypeSpecifier |
createBanded(ColorSpace colorSpace,
int[] bankIndices,
int[] bandOffsets,
int dataType,
boolean hasAlpha,
boolean isAlphaPremultiplied)
返回带状图像格式的说明符,它将使用 ComponentColorModel 和 BandedSampleModel 来存储单独数组中的每个通道。 |
BufferedImage |
createBufferedImage(int width,
int height)
根据此对象中包含的规范创建一个具有给定宽度和高度的 BufferedImage 。 |
static ImageTypeSpecifier |
createFromBufferedImageType(int bufferedImageType)
返回一个 ImageTypeSpecifier ,它将对某一标准 BufferedImage 类型(而不是 TYPE_CUSTOM )进行编码。 |
static ImageTypeSpecifier |
createFromRenderedImage(RenderedImage image)
返回一个 ImageTypeSpecifier ,它将对 RenderedImage (可能是 BufferedImage )的布局进行编码。 |
static ImageTypeSpecifier |
createGrayscale(int bits,
int dataType,
boolean isSigned)
返回灰度级图像格式的说明符,它会将给定位深 (bit depth) 的像素压缩成指定数据类型的数组元素。 |
static ImageTypeSpecifier |
createGrayscale(int bits,
int dataType,
boolean isSigned,
boolean isAlphaPremultiplied)
返回灰度级图像格式和 alpha 图像格式的说明符,它会将给定位深的像素压缩成指定数据类型的数组元素。 |
static ImageTypeSpecifier |
createIndexed(byte[] redLUT,
byte[] greenLUT,
byte[] blueLUT,
byte[] alphaLUT,
int bits,
int dataType)
返回索引颜色图像格式的说明符,它将给定位深的索引值压缩成指定数据类型的数组元素。 |
static ImageTypeSpecifier |
createInterleaved(ColorSpace colorSpace,
int[] bandOffsets,
int dataType,
boolean hasAlpha,
boolean isAlphaPremultiplied)
返回交错图像格式的说明符,它将使用 ComponentColorModel 和 PixelInterleavedSampleModel 来存储单个 byte、short 或 int 值形式的每个像素组件。 |
static ImageTypeSpecifier |
createPacked(ColorSpace colorSpace,
int redMask,
int greenMask,
int blueMask,
int alphaMask,
int transferType,
boolean isAlphaPremultiplied)
返回压缩图像格式的说明符,它将使用 DirectColorModel 和一个压缩的 SampleModel 来存储压缩成单个 byte、short 或 int 值的像素。 |
boolean |
equals(Object o)
如果给定 Object 是一个 ImageTypeSpecifier 并且具有与此对象相同的 SampleModel 和 ColorModel ,则返回 true 。 |
int |
getBitsPerBand(int band)
返回用来表示给定 band 样本的位数。 |
int |
getBufferedImageType()
返回一个 int 值,它包含某一来自 BufferedImage 的描述图像的枚举常量值。 |
ColorModel |
getColorModel()
返回此对象指定的 ColorModel 。 |
int |
getNumBands()
返回此对象指定的 band 数。 |
int |
getNumComponents()
返回此对象指定的颜色组件的数量。 |
SampleModel |
getSampleModel()
根据此对象中封装的设置返回一个 SampleModel 。 |
SampleModel |
getSampleModel(int width,
int height)
根据此对象中封装的设置值返回一个 SampleModel 。 |
int |
hashCode()
返回此 ImageTypeSpecifier 的哈希码。 |
从类 java.lang.Object 继承的方法 |
---|
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait |
字段详细信息 |
---|
protected ColorModel colorModel
ColorModel
。
protected SampleModel sampleModel
SampleModel
。
构造方法详细信息 |
---|
public ImageTypeSpecifier(ColorModel colorModel, SampleModel sampleModel)
ColorModel
和 SampleModel
构造一个 ImageTypeSpecifier
。由调用者负责提供兼容的参数。
colorModel
- 一个 ColorModel
。sampleModel
- 一个 SampleModel
。
IllegalArgumentException
- 如果任意一个参数为 null
。
IllegalArgumentException
- 如果 sampleModel
与 colorModel
不兼容。public ImageTypeSpecifier(RenderedImage image)
RenderedImage
构造一个 ImageTypeSpecifier
。如果使用的是 BufferedImage
,为了获得更精确的结果,应该使用 createFromRenderedImage
或 createFromBufferedImageType
这两个工厂方法之一。
image
- 一个 RenderedImage
。
IllegalArgumentException
- 如果该参数为 null
。方法详细信息 |
---|
public static ImageTypeSpecifier createPacked(ColorSpace colorSpace, int redMask, int greenMask, int blueMask, int alphaMask, int transferType, boolean isAlphaPremultiplied)
DirectColorModel
和一个压缩的 SampleModel
来存储压缩成单个 byte、short 或 int 值的像素。
colorSpace
- 所需的 ColorSpace
。redMask
- 指示红色通道位置的邻接掩码。greenMask
- 指示绿色通道位置的邻接掩码。blueMask
- 指示蓝色通道位置的邻接掩码。alphaMask
- 指示 alpha 通道位置的邻接掩码。transferType
- 所需的 SampleModel
传输类型。isAlphaPremultiplied
- 如果颜色通道将预乘以 alpha 通道,则该参数为 true
。
ImageTypeSpecifier
。
IllegalArgumentException
- 如果 colorSpace
为 null
。
IllegalArgumentException
- 如果 colorSpace
的类型不是 TYPE_RGB
。
IllegalArgumentException
- 如果没有掩码至少有一个位集。
IllegalArgumentException
- 如果 transferType
不是 DataBuffer.TYPE_BYTE
、DataBuffer.TYPE_USHORT
或 DataBuffer.TYPE_INT
之一。public static ImageTypeSpecifier createInterleaved(ColorSpace colorSpace, int[] bandOffsets, int dataType, boolean hasAlpha, boolean isAlphaPremultiplied)
ComponentColorModel
和 PixelInterleavedSampleModel
来存储单个 byte、short 或 int 值形式的每个像素组件。
colorSpace
- 所需的 ColorSpace
。bandOffsets
- 指示每个 band 的偏移量的 int
数组。dataType
- 所需的数据类型,它是 DataBuffer
类中的枚举之一。hasAlpha
- 如果需要 alpha 通道,则该参数为 true
。isAlphaPremultiplied
- 如果颜色通道将预乘以 alpha 通道,则该参数为 true
。
ImageTypeSpecifier
。
IllegalArgumentException
- 如果 colorSpace
为 null
。
IllegalArgumentException
- 如果 bandOffsets
为 null
。
IllegalArgumentException
- 如果 dataType
不是合法的 DataBuffer.TYPE_*
常量之一。
IllegalArgumentException
- 如果 bandOffsets.length
不等于颜色空间组件的数量;如果 hasAlpha
为 true
时,该长度不等于组件数量加 1。public static ImageTypeSpecifier createBanded(ColorSpace colorSpace, int[] bankIndices, int[] bandOffsets, int dataType, boolean hasAlpha, boolean isAlphaPremultiplied)
ComponentColorModel
和 BandedSampleModel
来存储单独数组中的每个通道。
colorSpace
- 所需的 ColorSpace
。bankIndices
- 一个 int
数组,指示用来存储每个 band 的库。bandOffsets
- 一个 int
数组,指示其库中每个 band 的起始偏移量。dataType
- 所需的数据类型,它是 DataBuffer
类中的枚举之一。hasAlpha
- 如果需要 alpha 通道,则该参数为 true
。isAlphaPremultiplied
- 如果颜色通道将预乘以 alpha 通道,则该参数为 true
。
ImageTypeSpecifier
。
IllegalArgumentException
- 如果 colorSpace
为 null
。
IllegalArgumentException
- 如果 bankIndices
为 null
。
IllegalArgumentException
- 如果 bandOffsets
为 null
。
IllegalArgumentException
- 如果 bankIndices
和 bandOffsets
的长度不同。
IllegalArgumentException
- 如果 bandOffsets.length
不等于颜色空间组件的数量;如果 hasAlpha
为 true
时,该长度不等于组件数量加 1。
IllegalArgumentException
- 如果 dataType
不是合法的 DataBuffer.TYPE_*
常量之一。public static ImageTypeSpecifier createGrayscale(int bits, int dataType, boolean isSigned)
bits
- 每个灰度值的位数(1、2、4、8 或 16)。dataType
- 所需的数据类型,它是 DataBuffer
类中的枚举之一。isSigned
- 如果要表示负值,则该参数为 true
。
ImageTypeSpecifier
。
IllegalArgumentException
- 如果 bits
不是 1、2、4、8 或 16 之一。
IllegalArgumentException
- 如果 dataType
不是 DataBuffer.TYPE_BYTE
、DataBuffer.TYPE_SHORT
或 DataBuffer.TYPE_USHORT
之一。
IllegalArgumentException
- 如果 bits
大于给定 dataType
的位大小。public static ImageTypeSpecifier createGrayscale(int bits, int dataType, boolean isSigned, boolean isAlphaPremultiplied)
bits
- 每个灰度值的位数(1、2、4、8 或 16)。dataType
- 所需的数据类型,它是 DataBuffer
类中的枚举之一。isSigned
- 如果要表示负值,则该参数为 true
。isAlphaPremultiplied
- 如果亮度通道将乘以 alpha 通道,则该参数为 true
。
ImageTypeSpecifier
。
IllegalArgumentException
- 如果 bits
不是 1、2、4、8 或 16 之一。
IllegalArgumentException
- 如果 dataType
不是 DataBuffer.TYPE_BYTE
、DataBuffer.TYPE_SHORT
或 DataBuffer.TYPE_USHORT
之一。
IllegalArgumentException
- 如果 bits
大于给定 dataType
的位大小。public static ImageTypeSpecifier createIndexed(byte[] redLUT, byte[] greenLUT, byte[] blueLUT, byte[] alphaLUT, int bits, int dataType)
redLUT
- 一个 byte
数组,包含每个索引的 red 值。greenLUT
- 一个 byte
数组,包含每个索引的 green 值。blueLUT
- 一个 byte
数组,包含每个索引的 blue 值。alphaLUT
- 一个 byte
数组,包含每个索引的 alpha 值;或者为 null
,表示创建一个完全不透明的 LUT。bits
- 每个索引中的位数。dataType
- 所需的输出类型,它是 DataBuffer
类中的枚举之一。
ImageTypeSpecifier
。
IllegalArgumentException
- 如果 redLUT
为 null
。
IllegalArgumentException
- 如果 greenLUT
为 null
。
IllegalArgumentException
- 如果 blueLUT
为 null
。
IllegalArgumentException
- 如果 bits
不是 1、2、4、8 或 16 之一。
IllegalArgumentException
- 如果非 null
LUT 参数的长度不能正好满足 1 << bits
。
IllegalArgumentException
- 如果 dataType
不是 DataBuffer.TYPE_BYTE
、DataBuffer.TYPE_SHORT
、DataBuffer.TYPE_USHORT
或 DataBuffer.TYPE_INT
之一。
IllegalArgumentException
- 如果 bits
大于给定 dataType
的位大小。public static ImageTypeSpecifier createFromBufferedImageType(int bufferedImageType)
ImageTypeSpecifier
,它将对某一标准 BufferedImage
类型(而不是 TYPE_CUSTOM
)进行编码。
bufferedImageType
- 表示某一标准 BufferedImage
类型的 int 值。
ImageTypeSpecifier
。
IllegalArgumentException
- 如果 bufferedImageType
不是标准类型之一,或者它等于 TYPE_CUSTOM
。BufferedImage
,
BufferedImage.TYPE_INT_RGB
,
BufferedImage.TYPE_INT_ARGB
,
BufferedImage.TYPE_INT_ARGB_PRE
,
BufferedImage.TYPE_INT_BGR
,
BufferedImage.TYPE_3BYTE_BGR
,
BufferedImage.TYPE_4BYTE_ABGR
,
BufferedImage.TYPE_4BYTE_ABGR_PRE
,
BufferedImage.TYPE_USHORT_565_RGB
,
BufferedImage.TYPE_USHORT_555_RGB
,
BufferedImage.TYPE_BYTE_GRAY
,
BufferedImage.TYPE_USHORT_GRAY
,
BufferedImage.TYPE_BYTE_BINARY
,
BufferedImage.TYPE_BYTE_INDEXED
public static ImageTypeSpecifier createFromRenderedImage(RenderedImage image)
ImageTypeSpecifier
,它将对 RenderedImage
(可能是 BufferedImage
)的布局进行编码。
image
- 一个 RenderedImage
。
ImageTypeSpecifier
。
IllegalArgumentException
- 如果 image
为 null
。public int getBufferedImageType()
BufferedImage
的描述图像的枚举常量值。
BufferedImage
类型的 int
。BufferedImage
,
BufferedImage.TYPE_CUSTOM
,
BufferedImage.TYPE_INT_RGB
,
BufferedImage.TYPE_INT_ARGB
,
BufferedImage.TYPE_INT_ARGB_PRE
,
BufferedImage.TYPE_INT_BGR
,
BufferedImage.TYPE_3BYTE_BGR
,
BufferedImage.TYPE_4BYTE_ABGR
,
BufferedImage.TYPE_4BYTE_ABGR_PRE
,
BufferedImage.TYPE_USHORT_565_RGB
,
BufferedImage.TYPE_USHORT_555_RGB
,
BufferedImage.TYPE_BYTE_GRAY
,
BufferedImage.TYPE_USHORT_GRAY
,
BufferedImage.TYPE_BYTE_BINARY
,
BufferedImage.TYPE_BYTE_INDEXED
public int getNumComponents()
ColorModel.getNumComponents
返回的值。
public int getNumBands()
SampleModel.getNumBands
返回的值。
public int getBitsPerBand(int band)
band
- 将被查询的 band 的索引(int 值形式)。
IllegalArgumentException
- 如果 band
为负或大于最大 band 索引。public SampleModel getSampleModel()
SampleModel
。SampleModel
的宽度和高度将被设置为任意值。
SampleModel
。public SampleModel getSampleModel(int width, int height)
SampleModel
。SampleModel
的宽度和高度将被设置为所提供的值。
width
- 返回的 SampleModel
的所需宽度。height
- 返回的 SampleModel
的所需高度。
SampleModel
。
IllegalArgumentException
- 如果 width
或 height
为负数或零。
IllegalArgumentException
- 如果 width
和 height
的值大于 Integer.MAX_VALUE
public ColorModel getColorModel()
ColorModel
。
ColorModel
。public BufferedImage createBufferedImage(int width, int height)
BufferedImage
。
width
- 返回的 BufferedImage
的所需宽度。height
- 返回的 BufferedImage
的所需高度。
BufferedImage
IllegalArgumentException
- 如果 width
或 height
为负数或零。
IllegalArgumentException
- 如果 width
和 height
的值大于 Integer.MAX_VALUE
,或者存储图像所需的数组元素数大于 Integer.MAX_VALUE
。public boolean equals(Object o)
Object
是一个 ImageTypeSpecifier
并且具有与此对象相同的 SampleModel
和 ColorModel
,则返回 true
。
Object
中的 equals
o
- 将用于相等性比较的 Object
。
ImageTypeSpecifier
,则返回 true
。Object.hashCode()
,
Hashtable
public int hashCode()
Object
中的 hashCode
Object.equals(java.lang.Object)
,
Hashtable
|
JavaTM Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。