Spec-Zone.ru › OpenJDK 27

Класс 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)
Возвращает спецификатор для чересстрочного формата изображения, который будет использовать ComponentColorModel и PixelInterleavedSampleModel для хранения каждого компонента пикселя в отдельном байте, 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)
Возвращает 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
Модификатор и тип Метод Описание
protected Object clone()
Создает и возвращает копию этого объекта.
protected void finalize()
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Финализация объявлена устаревшей и подлежит удалению в одном из будущих выпусков.
final Class<?> getClass()
Возвращает класс времени выполнения этого Object.
final void notify()
Пробуждает один поток, ожидающий на мониторе этого объекта.
final void notifyAll()
Пробуждает все потоки, ожидающие на мониторе этого объекта.
String toString()
Возвращает строковое представление объекта.
final void wait()
Приостанавливает выполнение текущего потока до его пробуждения, обычно вследствие вызова notify или interrupt.
final void wait(long timeoutMillis)
Приостанавливает выполнение текущего потока до его пробуждения, обычно вследствие вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
final void wait(long timeoutMillis, int nanos)
Приостанавливает выполнение текущего потока до его пробуждения, обычно вследствие вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

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

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)
Возвращает спецификатор упакованного формата изображения, который использует DirectColorModel и упакованный SampleModel для хранения каждого пикселя, упакованного в один байт, короткое целое или целое.
Параметры:
colorSpace — требуемое ColorSpace.
redMask — непрерывная маска, указывающая положение красного канала.
greenMask — непрерывная маска, указывающая положение зеленого канала.
blueMask — непрерывная маска, указывающая положение синего канала.
alphaMask — непрерывная маска, указывающая положение альфа-канала.
transferType — требуемый тип передачи данных SampleModel.
isAlphaPremultiplied — true, если цветовые каналы будут предварительно умножены на альфа-канал.
Возвращает:
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 для хранения каждого компонента пикселя в отдельном байте, коротком целом или целом.
Параметры:
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 — целое число, представляющее один из стандартных типов 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()
Возвращает целое число, содержащее одно из перечислимых значений констант, описывающих форматы изображений из 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 — индекс запрашиваемой полосы в виде целого числа.
Возвращает:
целое число, задающее количество бит.
Исключения:
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, 2026, 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.

Spec-Zone.ru

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