Класс ImageTypeSpecifier

public class ImageTypeSpecifier
extends Object

Поля

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 без прозрачности не имеют длину ровно 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, равные соответствующим значениям этого объекта.

Переопределяет:

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)