Spec-Zone.ru › OpenJDK 25

Класс ImageTypeSpecifier

java.lang.Object
javax.imageio.ImageTypeSpecifier
public class ImageTypeSpecifier extends Object
Класс, позволяющий удобным образом задавать формат изображения (в частности, его SampleModel и ColorModel).

Краткое описание полей

Модификатор и тип Поле Описание
protected ColorModel colorModel
ColorModel, используемый в качестве прототипа.
protected SampleModel sampleModel
SampleModel, используемая в качестве прототипа.

Краткое описание конструкторов

Конструктор Описание
ImageTypeSpecifier(ColorModel colorModel, SampleModel sampleModel)
Создает ImageTypeSpecifier непосредственно из ColorModel и SampleModel.
ImageTypeSpecifier(RenderedImage image)
Создает ImageTypeSpecifier из RenderedImage.

Краткое описание методов

Модификатор и тип Метод Описание
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)
Возвращает спецификатор для формата изображения в градациях серого с альфа-каналом, который упаковывает пиксели заданной глубины цвета в элементы массива указанного типа данных.
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)
Возвращает спецификатор для чередующегося формата изображения, в котором для хранения каждого компонента пикселя в отдельном байте, значении short или int используются ComponentColorModel и PixelInterleavedSampleModel.
static ImageTypeSpecifier createPacked(ColorSpace colorSpace, int redMask, int greenMask, int blueMask, int alphaMask, int transferType, boolean isAlphaPremultiplied)
Возвращает спецификатор для упакованного формата изображения, в котором для хранения каждого упакованного пикселя в одном байте, значении short или int используются DirectColorModel и упакованный SampleModel.
boolean equals(Object o)
Возвращает true, если заданный Object является ImageTypeSpecifier и имеет SampleModel и ColorModel, совпадающие с таковыми у этого объекта.
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.

Методы, объявленные в классе Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Подробное описание полей

colorModel

protected ColorModel colorModel
ColorModel, используемый в качестве прототипа.

sampleModel

protected SampleModel sampleModel
SampleModel, используемая в качестве прототипа.

Подробное описание конструкторов

ImageTypeSpecifier

public ImageTypeSpecifier(ColorModel colorModel, SampleModel sampleModel)
Создает ImageTypeSpecifier непосредственно из ColorModel и SampleModel. Вызывающий код должен предоставить совместимые параметры.
Параметры:
colorModel — ColorModel.
sampleModel — SampleModel.
Исключения:
IllegalArgumentException — если один из параметров равен null.
IllegalArgumentException — если sampleModel несовместима с colorModel.

ImageTypeSpecifier

public ImageTypeSpecifier(RenderedImage image)
Создает ImageTypeSpecifier из RenderedImage. Если используется BufferedImage, вместо этого следует использовать один из фабричных методов createFromRenderedImage или createFromBufferedImageType, чтобы получить более точный результат.
Параметры:
image — RenderedImage.
Исключения:
IllegalArgumentException — если аргумент равен null.

Подробное описание методов

createPacked

public static ImageTypeSpecifier createPacked(ColorSpace colorSpace, int redMask, int greenMask, int blueMask, int alphaMask, int transferType, boolean isAlphaPremultiplied)
Возвращает спецификатор для упакованного формата изображения, в котором для хранения каждого упакованного пикселя в одном байте, значении short или int используются DirectColorModel и упакованный SampleModel.
Параметры:
colorSpace — требуемое ColorSpace.
redMask — непрерывная маска, указывающая положение красного канала.
greenMask — непрерывная маска, указывающая положение зеленого канала.
blueMask — непрерывная маска, указывающая положение синего канала.
alphaMask — непрерывная маска, указывающая положение альфа-канала.
transferType — требуемый тип передачи SampleModel.
isAlphaPremultiplied — true, если цветовые каналы будут умножаться на альфа-канал.
Возвращает:
ImageTypeSpecifier с требуемыми характеристиками.
Исключения:
IllegalArgumentException — если colorSpace равен null.
IllegalArgumentException — если colorSpace имеет тип, отличный от TYPE_RGB.
IllegalArgumentException — если ни в одной маске не установлен хотя бы один бит.
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)
Возвращает спецификатор для чередующегося формата изображения, в котором для хранения каждого компонента пикселя в отдельном байте, значении short или int используются ComponentColorModel и PixelInterleavedSampleModel.
Параметры:
colorSpace — требуемое ColorSpace.
bandOffsets — массив int, задающих смещения для каждой полосы.
dataType — требуемый тип данных, одно из перечислений класса DataBuffer.
hasAlpha — true, если требуется альфа-канал.
isAlphaPremultiplied — true, если цветовые каналы будут умножаться на альфа-канал.
Возвращает:
ImageTypeSpecifier с требуемыми характеристиками.
Исключения:
IllegalArgumentException — если colorSpace равен null.
IllegalArgumentException — если bandOffsets равен null.
IllegalArgumentException — если dataType не является одной из допустимых констант DataBuffer.TYPE_*.
IllegalArgumentException — если bandOffsets.length не равно числу компонентов цветового пространства плюс 1, если hasAlpha равно true.

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, если требуется альфа-канал.
isAlphaPremultiplied — true, если цветовые каналы будут умножаться на альфа-канал.
Возвращает:
ImageTypeSpecifier с требуемыми характеристиками.
Исключения:
IllegalArgumentException — если colorSpace равен null.
IllegalArgumentException — если bankIndices равен null.
IllegalArgumentException — если bandOffsets равен null.
IllegalArgumentException — если длины bankIndices и bandOffsets различаются.
IllegalArgumentException — если bandOffsets.length не равно числу компонентов цветового пространства плюс 1, если hasAlpha равно true.
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)
Возвращает спецификатор для формата изображения в градациях серого с альфа-каналом, который упаковывает пиксели заданной глубины цвета в элементы массива указанного типа данных.
Параметры:
bits — число битов на значение серого (1, 2, 4, 8 или 16).
dataType — требуемый тип данных, одно из перечислений класса DataBuffer.
isSigned — true, если требуется представлять отрицательные значения.
isAlphaPremultiplied — true, если канал яркости будет умножаться на альфа-канал.
Возвращает:
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 — массив byte, содержащих значения альфа-канала для каждого индекса, или null для создания полностью непрозрачной LUT.
bits — число битов в каждом индексе.
dataType — требуемый тип вывода, одно из перечислений класса DataBuffer.
Возвращает:
ImageTypeSpecifier с требуемыми характеристиками.
Исключения:
IllegalArgumentException — если redLUT равен null.
IllegalArgumentException — если greenLUT равен null.
IllegalArgumentException — если blueLUT равен null.
IllegalArgumentException — если bits не равно 1, 2, 4, 8 или 16.
IllegalArgumentException — если длина параметров LUT, отличных от null, не равна в точности 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 — значение int, представляющее один из стандартных типов BufferedImage.
Возвращает:
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 — RenderedImage.
Возвращает:
ImageTypeSpecifier с требуемыми характеристиками.
Исключения:
IllegalArgumentException — если image равен null.

getBufferedImageType

public int getBufferedImageType()
Возвращает значение int, содержащее одну из перечисленных констант, описывающих форматы изображений из BufferedImage.
Возвращает:
int, представляющее тип 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 заданной ширины и высоты в соответствии со спецификацией, представленной этим объектом.
Параметры:
width — требуемая ширина возвращаемого BufferedImage.
height — требуемая высота возвращаемого BufferedImage.
Возвращает:
новый BufferedImage
Исключения:
IllegalArgumentException — если width или height отрицательны либо равны нулю.
IllegalArgumentException — если произведение width и height больше Integer.MAX_VALUE или если число элементов массива, необходимых для хранения изображения, больше Integer.MAX_VALUE.

equals

public boolean equals(Object o)
Возвращает true, если заданный Object является ImageTypeSpecifier и имеет SampleModel и ColorModel, совпадающие с таковыми у этого объекта.
Переопределяет:
equals в классе Object
Параметры:
o — Object, с которым сравнивается объект.
Возвращает:
true, если заданный объект эквивалентен ImageTypeSpecifier.
См. также:
  • Object.hashCode()
  • HashMap

hashCode

public int hashCode()
Возвращает хеш-код этого ImageTypeSpecifier.
Переопределяет:
hashCode в классе Object
Возвращает:
хеш-код этого ImageTypeSpecifier
См. также:
  • Object.equals(java.lang.Object)
  • System.identityHashCode(Object)

Сообщить об ошибке или предложить улучшение
Дополнительные справочные материалы по API и документацию для разработчиков см. в разделе документации Java SE, содержащем более подробные описания для разработчиков, обзоры концепций, определения терминов, обходные решения и примеры работающего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторское право © 1993, 2025, Oracle и/или ее аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/imageio/ImageTypeSpecifier.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API