Spec-Zone.ru › OpenJDK 17

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

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

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 - массив ints, указывающих смещения для каждого канала.
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 - массив ints, указывающих банк, в котором будет храниться каждый канал.
bandOffsets - массив ints, указывающих начальное смещение каждого канала в его банке.
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.
Возвращает:
целое число, представляющее тип 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, равные соответствующим значениям этого объекта.
Overrides:
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)

© 1993, 2021, 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/17/docs/api/java.desktop/javax/imageio/ImageTypeSpecifier.html

Spec-Zone.ru

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