ImageTypeSpecifier (Java Platform SE 8 )

java.lang.Object
- javax.imageio.ImageTypeSpecifier

```
public class ImageTypeSpecifier
extends Object
```
允许以方便的方式指定图像的格式（特别是其 SampleModel和 ColorModel ）的类。

Field Summary

Fields
Modifier and Type	Field and Description
`protected ColorModel`	`colorModel` `ColorModel`被用作原型。
`protected SampleModel`	`sampleModel` A `SampleModel`用作原型。

构造方法摘要

构造方法
Constructor and Description
`ImageTypeSpecifier(ColorModel colorModel, SampleModel sampleModel)` 构造一个 `ImageTypeSpecifier`直接从 `ColorModel`和 `SampleModel` 。
`ImageTypeSpecifier(RenderedImage image)` 从 `RenderedImage` `ImageTypeSpecifier`一个 `RenderedImage` 。

方法摘要

所有方法静态方法接口方法具体的方法
Modifier and Type	Method and Description
`static ImageTypeSpecifier`	`createBanded(ColorSpace colorSpace, int[] bankIndices, int[] bandOffsets, int dataType, boolean hasAlpha, boolean isAlphaPremultiplied)` 返回一个带状图像格式的说明符，该格式将使用 `ComponentColorModel`和 `BandedSampleModel`将每个通道存储在单独的数组中。
`BufferedImage`	`createBufferedImage(int width, int height)` 根据此对象中体现的 `BufferedImage` ，创建一个给定宽度和高度的BufferedImage。
`static ImageTypeSpecifier`	`createFromBufferedImageType(int bufferedImageType)` 返回一个 `ImageTypeSpecifier`为 `BufferedImage`类型之一（ `TYPE_CUSTOM` ）的 `TYPE_CUSTOM` 。
`static ImageTypeSpecifier`	`createFromRenderedImage(RenderedImage image)` 返回一个 `ImageTypeSpecifier` ，编码一个 `RenderedImage` （可能是一个 `BufferedImage` ）的布局。
`static ImageTypeSpecifier`	`createGrayscale(int bits, int dataType, boolean isSigned)` 返回一个灰度图像格式的说明符，该格式将将给定位深度的像素包装为指定数据类型的数组元素。
`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`将每个像素组件存储在单独的字节，短或int中。
`static ImageTypeSpecifier`	`createPacked(ColorSpace colorSpace, int redMask, int greenMask, int blueMask, int alphaMask, int transferType, boolean isAlphaPremultiplied)` 返回一个用于打包图像格式的说明符，它将使用 `DirectColorModel`和打包的 `SampleModel`来存储单个字节，短或int中打包的每个像素。
`boolean`	`equals(Object o)` 如果给定的 `Object`是 `ImageTypeSpecifier` ，并且具有与该对象相同的 `SampleModel`和 `ColorModel` ，则返回 `true` 。
`int`	`getBitsPerBand(int band)` 返回用于表示给定波段的样本的位数。
`int`	`getBufferedImageType()` 返回包含描述从图像的枚举常数值之一的int `BufferedImage` 。
`ColorModel`	`getColorModel()` 返回此对象指定的 `ColorModel` 。
`int`	`getNumBands()` 返回此对象指定的频带数。
`int`	`getNumComponents()` 返回此对象指定的颜色成分数。
`SampleModel`	`getSampleModel()` 根据封装在此对象内的设置返回一个 `SampleModel` 。
`SampleModel`	`getSampleModel(int width, int height)` 根据封装在此对象内的设置返回 `SampleModel` 。
`int`	`hashCode()` 返回此ImageTypeSpecifier的哈希码。

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

- 字段详细信息
  - colorModel
```
protected ColorModel colorModel
```
    将 ColorModel作为原型使用。
  - sampleModel
```
protected SampleModel sampleModel
```
    A SampleModel用作原型。
- 构造方法详细信息
  - ImageTypeSpecifier
```
public ImageTypeSpecifier(ColorModel colorModel,
                          SampleModel sampleModel)
```
    构造一个ImageTypeSpecifier直接从ColorModel和SampleModel 。主叫方有责任提供兼容的参数。
    
    参数
    
    colorModel - a ColorModel 。
    
    sampleModel - a SampleModel 。
    
    异常
    
    IllegalArgumentException - 如果任一参数是 null 。
    
    IllegalArgumentException -如果 sampleModel不兼容 colorModel 。
  - ImageTypeSpecifier
```
public ImageTypeSpecifier(RenderedImage image)
```
    从RenderedImage ImageTypeSpecifier一个RenderedImage 。如果正在使用BufferedImage使用其中一种工厂方法createFromRenderedImage或createFromBufferedImageType ，以获得更准确的结果。
    
    参数
    
    image - a RenderedImage 。
    
    异常
    
    IllegalArgumentException - 如果参数是 null 。
- 方法详细信息
  - createPacked
```
public static ImageTypeSpecifier createPacked(ColorSpace colorSpace,
                                              int redMask,
                                              int greenMask,
                                              int blueMask,
                                              int alphaMask,
                                              int transferType,
                                              boolean isAlphaPremultiplied)
```
    返回一个打包图像格式的说明符，该格式将使用 DirectColorModel和打包的 SampleModel来存储单个字节，短或整数的每个像素。
    
    参数
    
    colorSpace - 所需的 ColorSpace 。
    
    redMask - 连续的掩码表示红色通道的位置。
    
    greenMask - 连续的掩码表示绿色通道的位置。
    
    blueMask - 连续的掩模表示蓝色通道的位置。
    
    alphaMask - 连续的掩码表示阿尔法通道的位置。
    
    transferType - 所需的 SampleModel传输类型。
    
    isAlphaPremultiplied - true如果颜色通道将被alpha通道预乘。
    
    结果
    
    一个 ImageTypeSpecifier具有所需特性。
    
    异常
    
    IllegalArgumentException - 如果 colorSpace是 null 。
    
    IllegalArgumentException - 如果 colorSpace不是类型 TYPE_RGB 。
    
    IllegalArgumentException - 如果没有掩码至少设置1位。
    
    IllegalArgumentException -如果 transferType如果不是一个 DataBuffer.TYPE_BYTE ， DataBuffer.TYPE_USHORT ，或 DataBuffer.TYPE_INT 。
  - createInterleaved
```
public static ImageTypeSpecifier createInterleaved(ColorSpace colorSpace,
                                                   int[] bandOffsets,
                                                   int dataType,
                                                   boolean hasAlpha,
                                                   boolean isAlphaPremultiplied)
```
    返回一个交织图像格式的说明符，该格式将使用 ComponentColorModel和 PixelInterleavedSampleModel将每个像素组件存储在单独的字节，短或int中。
    
    参数
    
    colorSpace - 所需的 ColorSpace 。
    
    bandOffsets - 表示每个频带的偏移的 int的数组。
    
    dataType - 所需的数据类型，作为 DataBuffer类的 DataBuffer 。
    
    hasAlpha - true如果需要alpha通道。
    
    isAlphaPremultiplied - true如果颜色通道将被alpha通道预乘。
    
    结果
    
    一个 ImageTypeSpecifier具有所需的特性。
    
    异常
    
    IllegalArgumentException - 如果 colorSpace是 null 。
    
    IllegalArgumentException - 如果 bandOffsets是 null 。
    
    IllegalArgumentException - 如果 dataType不是合法的 DataBuffer.TYPE_*常数之一。
    
    IllegalArgumentException - 如果 bandOffsets.length不等于颜色空间分量的数量，如果 hasAlpha是 true ，则加1。
  - createBanded
```
public static ImageTypeSpecifier createBanded(ColorSpace colorSpace,
                                              int[] bankIndices,
                                              int[] bandOffsets,
                                              int dataType,
                                              boolean hasAlpha,
                                              boolean isAlphaPremultiplied)
```
    返回带状图像格式的说明符，该格式将使用 ComponentColorModel和 BandedSampleModel将每个通道存储在单独的阵列中。
    
    参数
    
    colorSpace - 所需的 ColorSpace 。
    
    bankIndices - 表示其中将存储每个频带的组的 int的阵列。
    
    bandOffsets - int s的数组， int其银行中每个频带的起始偏移量。
    
    dataType - 所需的数据类型，作为 DataBuffer类的 DataBuffer 。
    
    hasAlpha - true如果需要alpha通道。
    
    isAlphaPremultiplied - true如果颜色通道将被alpha通道预乘。
    
    结果
    
    一个 ImageTypeSpecifier具有所需的特性。
    
    异常
    
    IllegalArgumentException - 如果 colorSpace是 null 。
    
    IllegalArgumentException - 如果 bankIndices是 null 。
    
    IllegalArgumentException - 如果 bandOffsets是 null 。
    
    IllegalArgumentException - 如果 bankIndices和 bandOffsets的长度不同。
    
    IllegalArgumentException - 如果 bandOffsets.length不等于颜色空间分量的数量，如果 hasAlpha是 true ，则加1。
    
    IllegalArgumentException - 如果 dataType不是合法的 DataBuffer.TYPE_*常数之一。
  - createGrayscale
```
public static ImageTypeSpecifier createGrayscale(int bits,
                                                 int dataType,
                                                 boolean isSigned)
```
    返回一个灰度图像格式的说明符，该格式将将给定位深度的像素包装为指定数据类型的数组元素。
    
    参数
    
    bits - 每个灰度值的位数（ bits或16）。
    
    dataType - 所需的数据类型，作为 DataBuffer类的 DataBuffer 。
    
    isSigned - true如果要表示负值。
    
    结果
    
    一个 ImageTypeSpecifier具有所需特性。
    
    异常
    
    IllegalArgumentException - 如果 bits不是 bits或16中的一个。
    
    IllegalArgumentException -如果 dataType不是一个 DataBuffer.TYPE_BYTE ， DataBuffer.TYPE_SHORT ，或 DataBuffer.TYPE_USHORT 。
    
    IllegalArgumentException - 如果 bits大于给定 dataType的位大小。
  - createGrayscale
```
public static ImageTypeSpecifier createGrayscale(int bits,
                                                 int dataType,
                                                 boolean isSigned,
                                                 boolean isAlphaPremultiplied)
```
    返回一个用于灰度加Alpha图像格式的说明符，它将给定位深度的像素包装为指定数据类型的数组元素。
    
    参数
    
    bits - 每个灰度值的位数（ bits或16）。
    
    dataType - 所需的数据类型，作为 DataBuffer类的 DataBuffer 。
    
    isSigned - true如果要表示负值。
    
    isAlphaPremultiplied - true如果亮度通道将被alpha通道预乘。
    
    结果
    
    一个 ImageTypeSpecifier具有所需的特性。
    
    异常
    
    IllegalArgumentException - 如果 bits不是 bits或16中的一个。
    
    IllegalArgumentException -如果 dataType不是一个 DataBuffer.TYPE_BYTE ， DataBuffer.TYPE_SHORT ，或 DataBuffer.TYPE_USHORT 。
    
    IllegalArgumentException - 如果 bits大于给定 dataType的位大小。
  - createIndexed
```
public static ImageTypeSpecifier createIndexed(byte[] redLUT,
                                               byte[] greenLUT,
                                               byte[] blueLUT,
                                               byte[] alphaLUT,
                                               int bits,
                                               int dataType)
```
    返回索引颜色图像格式的说明符，该格式将给定位深度的索引值包装为指定数据类型的数组元素。
    
    参数
    
    redLUT - 包含每个索引的红色值的 byte s的数组。
    
    greenLUT - 一个 greenLUT的数组， byte *每个索引的绿色值。
    
    blueLUT - 包含每个索引的蓝色值的 byte s的数组。
    
    alphaLUT -的阵列 byte包含每个索引α值S，或 null创建完全不透明LUT。
    
    bits - 每个索引中的位数。
    
    dataType - 所需的输出类型，作为 DataBuffer类的 DataBuffer 。
    
    结果
    
    一个 ImageTypeSpecifier具有所需特性。
    
    异常
    
    IllegalArgumentException - 如果 redLUT是 null 。
    
    IllegalArgumentException - 如果 greenLUT是 null 。
    
    IllegalArgumentException - 如果 blueLUT是 null 。
    
    IllegalArgumentException - 如果 bits不是 bits或16中的一个。
    
    IllegalArgumentException - 如果非 null LUT参数的长度不正确为 1 << bits 。
    
    IllegalArgumentException -如果 dataType不是一个 DataBuffer.TYPE_BYTE ， DataBuffer.TYPE_SHORT ， DataBuffer.TYPE_USHORT ，或 DataBuffer.TYPE_INT 。
    
    IllegalArgumentException - 如果 bits大于给定 dataType的位大小。
  - createFromBufferedImageType
```
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
  - createFromRenderedImage
```
public static ImageTypeSpecifier createFromRenderedImage(RenderedImage image)
```
    返回一个 ImageTypeSpecifier编码 RenderedImage （可能是 BufferedImage ）的布局。
    
    参数
    
    image - a RenderedImage 。
    
    结果
    
    一个 ImageTypeSpecifier具有所需特性。
    
    异常
    
    IllegalArgumentException - 如果 image是 null 。
  - getBufferedImageType
```
public int getBufferedImageType()
```
    返回包含描述从图像的枚举常数值之一的int BufferedImage 。
    
    结果
    
    一个 int BufferedImage类型的 BufferedImage 。
    
    另请参见：
    
    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
  - getNumComponents
```
public int getNumComponents()
```
    返回此对象指定的颜色成分数。这与ColorModel.getNumComponents返回的值相同
    
    结果
    
    图像中的组件数量。
  - getNumBands
```
public int getNumBands()
```
    返回此对象指定的频带数。这与SampleModel.getNumBands返回的值相同
    
    结果
    
    图像中的乐队数量。
  - getBitsPerBand
```
public int getBitsPerBand(int band)
```
    返回用于表示给定波段的样本的位数。
    
    参数
    
    band - 要查询的乐队的索引，作为int。
    
    结果
    
    一个指定位数的int。
    
    异常
    
    IllegalArgumentException - 如果 band为负或大于最大频带索引。
  - getSampleModel
```
public SampleModel getSampleModel()
```
    基于此对象中封装的设置返回SampleModel 。 SampleModel的宽度和高度将被设置为任意值。
    
    结果
    
    一个 SampleModel任意尺寸。
  - getSampleModel
```
public SampleModel getSampleModel(int width,
                                  int height)
```
    根据封装在此对象内的设置返回一个SampleModel 。 SampleModel的宽度和高度将被设置为提供的值。
    
    参数
    
    width - 返回的所需宽度 SampleModel 。
    
    height - 返回的 SampleModel的期望高度。
    
    结果
    
    一个 SampleModel具有给定的尺寸。
    
    异常
    
    IllegalArgumentException - 如果 width或 height为负数或零。
    
    IllegalArgumentException - 如果 width和 height的产品大于 Integer.MAX_VALUE
  - getColorModel
```
public ColorModel getColorModel()
```
    返回此对象指定的 ColorModel 。
    
    结果
    
    一个 ColorModel 。
  - createBufferedImage
```
public BufferedImage createBufferedImage(int width,
                                         int height)
```
    根据此对象中体现的 BufferedImage ，创建一个给定宽度和高度的BufferedImage。
    
    参数
    
    width - 返回的所需宽度 BufferedImage 。
    
    height - 所需的高度返回的 BufferedImage 。
    
    结果
    
    一个新的 BufferedImage
    
    异常
    
    IllegalArgumentException - 如果 width或 height为负数或零。
    
    IllegalArgumentException - 如果 width和 height的产品大于 Integer.MAX_VALUE ，或者如果存储图像所需的数组元素数量大于 Integer.MAX_VALUE 。
  - equals
```
public boolean equals(Object o)
```
    如果给定的 Object是 ImageTypeSpecifier并且具有与该对象相同的 SampleModel和 ColorModel ，则返回 true 。
    
    重写：
    
    equals在 Object
    
    参数
    
    o - 要比较的 Object相等。
    
    结果
    
    true如果给定的对象是等效的 ImageTypeSpecifier 。
    
    另请参见：
    
    Object.hashCode() ， HashMap
  - hashCode
```
public int hashCode()
```
    返回此ImageTypeSpecifier的哈希码。
    
    重写：
    
    hashCode在 Object
    
    结果
    
    此ImageTypeSpecifier的哈希码
    
    另请参见：
    
    Object.equals(java.lang.Object) ， System.identityHashCode(java.lang.Object)

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class ImageTypeSpecifier

Field Summary

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

字段详细信息

colorModel

sampleModel

构造方法详细信息

ImageTypeSpecifier

ImageTypeSpecifier

方法详细信息

createPacked

createInterleaved

createBanded

createGrayscale

createGrayscale

createIndexed

createFromBufferedImageType

createFromRenderedImage

getBufferedImageType

getNumComponents

getNumBands

getBitsPerBand

getSampleModel

getSampleModel

getColorModel

createBufferedImage

equals

hashCode