模块  java.desktop
软件包  javax.imageio

Class ImageTypeSpecifier

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

    • 方法摘要

      所有方法  静态方法  实例方法 具体的方法 
      变量和类型 方法 描述
      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)
      返回灰度图像格式的说明符，该格式将给定位深度的像素打包到指定数据类型的数组元素中。
      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将打包的每个像素存储在单个字节，short或int中。
      boolean equals​(Object o)
      如果给定的 Object是 ImageTypeSpecifier并且具有与此对象相同的 SampleModel和 ColorModel ，则返回 true 。
      int getBitsPerBand​(int 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的哈希码。

    • 字段详细信息

      • colorModel

        protected ColorModel colorModel
        ColorModel用作原型。

      • sampleModel

        protected SampleModel sampleModel
        SampleModel用作原型。

    • 构造方法详细信息

      • ImageTypeSpecifier

        public ImageTypeSpecifier​(ColorModel colorModel,                          SampleModel sampleModel)
        构造一个ImageTypeSpecifier直接从ColorModel和SampleModel 。 呼叫者有责任提供兼容的参数。
        参数
        colorModel - a ColorModel 。
        sampleModel - 长 SampleModel 。
        异常
        IllegalArgumentException - 如果任一参数为 null 。
        IllegalArgumentException - 如果 sampleModel与 colorModel不兼容。

      • ImageTypeSpecifier

        public ImageTypeSpecifier​(RenderedImage image)
        构造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将每个像素打包到单个字节，short或int中。
        参数
        colorSpace - 所需的 ColorSpace 。
        redMask - 连续的掩码表示红色通道的位置。
        greenMask - 连续的掩码表示绿色通道的位置。
        blueMask - 连续的掩码表示蓝色通道的位置。
        alphaMask - 连续的掩码表示alpha通道的位置。
        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将每个像素组件存储在单独的byte，short或int中。
        参数
        colorSpace - 所需的 ColorSpace 。
        bandOffsets -的阵列 int以及指示每个波段的偏移。
        dataType - 所需的数据类型，作为 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以及指示开始其组内的每一频带的偏移。
        dataType - 所需的数据类型，作为 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 - 每个灰度值的位数（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的位大小。

      • createGrayscale

        public static ImageTypeSpecifier createGrayscale​(int bits,                                                 int dataType,                                                 boolean isSigned,                                                 boolean isAlphaPremultiplied)
        返回灰度加alpha图像格式的说明符，该格式将给定位深度的像素打包到指定数据类型的数组元素中。
        参数
        bits - 每灰度值的位数（1,2,4,8或16）。
        dataType - 所需的数据类型，作为 DataBuffer类的枚举之一。
        isSigned - true如果要表示负值。
        isAlphaPremultiplied - true如果亮度通道将由alpha通道预乘。
        结果
        具有所需特征的 ImageTypeSpecifier 。
        异常
        IllegalArgumentException - 如果 bits不是1,2,4,8或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数组。
        greenLUT - 包含*每个索引的绿色值的 byte数组。
        blueLUT - 包含每个索引的蓝色值的 byte数组。
        alphaLUT - 包含每个索引的alpha值的 byte数组，或 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的位大小。

      • createFromRenderedImage

        public static ImageTypeSpecifier createFromRenderedImage​(RenderedImage image)
        返回 ImageTypeSpecifier ，它编码 RenderedImage （可能是 BufferedImage ）的布局。
        参数
        image - a RenderedImage 。
        结果
        具有所需特征的 ImageTypeSpecifier 。
        异常
        IllegalArgumentException - 如果 image是 null 。

      • getNumComponents

        public int getNumComponents()
        返回此对象指定的颜色分量数。 这与ColorModel.getNumComponents返回的值相同
        结果
        图像中的组件数量。

      • getNumBands

        public int getNumBands()
        返回此对象指定的band数。 这与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 。
        参数
        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相等的 ColorModel ，则返回 true 。
        重写：
        equals类 Object
        参数
        o - 要比较的 Object是否相等。
        结果
        true如果给定对象是等效的 ImageTypeSpecifier 。
        另请参见：
        Object.hashCode() ， HashMap