java.awt.image

Класс ComponentColorModel

java.lang. Объект

java.awt.image. ColorModel

java.awt.image. ComponentColorModel

Все Реализованные Интерфейсы:

Прозрачность

public class ComponentColorModel
extends ColorModel

A ColorModel class, который работает с пиксельными значениями, которые представляют цвет и информацию об альфе как отдельные выборки и то хранилище каждая выборка в отдельном элементе данных. Этот class может использоваться с произвольным ColorSpace. Число цветных выборок в пиксельных значениях должно быть тем же самым как число компонентов цвета в ColorSpace. Может быть единственная альфа-выборка.

Для тех методов, которые используют примитивное пиксельное представление массива типа transferType, длина массива является тем же самым как числом альфа-выборок и цвета. Цветные выборки сохранены сначала в массиве, сопровождаемом альфа-выборкой, если существующий. Порядок цветных выборок определяется ColorSpace. Как правило, этот порядок отражает имя типа цветового пространства. Например, для TYPE_RGB, индексируйте 0, соответствует красный, индексируйте 1 к зеленому, и индексируйте 2 к синему.

Преобразование из пиксельной выборки оценивает компонентам цвета/альфы для дисплея, или цели обработки основано на взаимно-однозначном соответствии выборок к компонентам. В зависимости от типа передачи, используемого, чтобы создать экземпляр ComponentColorModel, пиксельные демонстрационные значения, представленные тем экземпляром, могут быть подписаны или без знака и могут быть целочисленного типа или плавать или удвоиться (см. ниже для деталей). Преобразование от демонстрационных значений до нормализованных компонентов цвета/альфы должно следовать за определенными правилами. Для плавания и двойных выборок, преобразование является идентификационными данными, то есть нормализованные компонентные значения равны соответствующим демонстрационным значениям. Для интегральных выборок преобразование должно быть только простым масштабом и сместить, где масштаб и смещал константы, может отличаться для каждого компонента. Результатом применения масштаба и констант смещения является ряд компонентных значений цвета/альфы, которые, как гарантируют, будут находиться в пределах определенного диапазона. Как правило, диапазон для компонента цвета будет диапазоном, определенным getMinValue и getMaxValue методы ColorSpace class. Диапазон для альфа-компонента должен быть 0.0 к 1.0.

Экземпляры ComponentColorModel создаваемый с типами передачи DataBuffer.TYPE_BYTE, DataBuffer.TYPE_USHORT, и DataBuffer.TYPE_INT имейте пиксельные демонстрационные значения, которые обрабатываются как интегральные значения без знака. Число битов в цвете или альфа-выборке пиксельного значения не могло бы быть тем же самым как числом битов для соответствующего цвета или альфа-выборки, которую передают к ComponentColorModel(ColorSpace, int[], boolean, boolean, int, int) конструктор. В этом случае этот class предполагает, что младшие значащие n биты демонстрационного значения содержат компонентное значение, где n является числом существенных битов для компонента, который передают конструктору. Это также предполагает, что любые биты высшего порядка в демонстрационном значении являются нулем. Таким образом выборка оценивает диапазон от 0 до ²ⁿ - 1. Этот class отображает эти, выборка оценивает нормализованным значениям компонента цвета так, что 0 карт к значению, полученному из ColorSpace's getMinValue метод для каждого компонента и ²ⁿ - 1 карта к значению, полученному из getMaxValue. Создать a ComponentColorModel с различным цветным демонстрационным отображением требует разделения на подклассы этого class и переопределения getNormalizedComponents(Object, float[], int) метод. Отображение для альфа-выборки всегда отображается 0 на 0.0 и ²ⁿ - 1 к 1.0.

Для экземпляров с демонстрационными значениями без знака только поддерживается ненормализованное компонентное представление цвета/альфы, если два условия содержат. Во-первых, демонстрационное значение оценивают 0, должен отобразиться на нормализованное компонентное значение 0.0 и демонстрационное значение ²ⁿ - 1 к 1.0. Второй минимальный диапазон / максимальный диапазон всех компонентов цвета ColorSpace должен быть 0.0 к 1.0. В этом случае компонентное представление является n младшими значащими битами соответствующей выборки. Таким образом каждый компонент является интегральным значением без знака между 0 и ²ⁿ - 1, где n является числом существенных битов для определенного компонента. Если эти условия не будут соблюдать, то любой метод, берущий ненормализованный компонентный параметр, бросит IllegalArgumentException.

Экземпляры ComponentColorModel создаваемый с типами передачи DataBuffer.TYPE_SHORT, DataBuffer.TYPE_FLOAT, и DataBuffer.TYPE_DOUBLE имейте пиксельные демонстрационные значения, которые обрабатываются как подписанные короткий, плавание, или двойные значения. Такие экземпляры не поддерживают ненормализованное компонентное представление цвета/альфы, таким образом, любые методы, берущие такое представление как параметр, бросят IllegalArgumentException когда обращено один из этих экземпляров. У нормализованных компонентных значений экземпляров этого class есть диапазон, который зависит от типа передачи следующим образом: для выборок плавающих, полного спектра типа данных float; для двойных выборок, полного спектра типа данных float (следующий из кастинга двойного по сравнению с плаванием); для кратких образцов, от приблизительно-maxVal к +maxVal, где maxVal на компонентное значение максимума для ColorSpace (-32767 карт к-maxVal, 0 карт к 0.0, и 32767 карт к +maxVal). Подкласс может переопределить масштабирование для значений краткого образца к нормализованным компонентным значениям, переопределяя getNormalizedComponents(Object, float[], int) метод. Для плавания и двойных выборок, нормализованные компонентные значения принимаются, чтобы быть равными соответствующим демонстрационным значениям, и подклассы не должны попытаться добавить любые неидентификационные данные, масштабирующиеся для этих типов передачи.

Экземпляры ComponentColorModel создаваемый с типами передачи DataBuffer.TYPE_SHORT, DataBuffer.TYPE_FLOAT, и DataBuffer.TYPE_DOUBLE используйте все биты всех демонстрационных значений. Таким образом у всех компонентов цвета/альфы есть 16 битов при использовании DataBuffer.TYPE_SHORT, 32 бита при использовании DataBuffer.TYPE_FLOAT, и 64 бита при использовании DataBuffer.TYPE_DOUBLE. Когда ComponentColorModel(ColorSpace, int[], boolean, boolean, int, int) форма конструктора используется с одним из этих типов передачи, параметр массива битов игнорируется.

Возможно иметь демонстрационные значения цвета/альфы, которые не могут быть разумно интерпретированы, поскольку компонент оценивает за рендеринг. Это может произойти когда ComponentColorModel разделяется на подклассы, чтобы переопределить отображение демонстрационных значений без знака к нормализованным значениям компонента цвета или когда подписанные демонстрационные значения вне определенного диапазона используются. (Как пример, определяя альфа-компонент, поскольку подписанное короткое значение вне диапазона от 0 до 32767, нормализованный диапазон 0.0 к 1.0, может привести к неожиданным результатам.) Это - обязанность приложений соответственно масштабироваться, пиксельные данные прежде, чем представить так, что компоненты цвета находятся в пределах нормализованного диапазона ColorSpace (полученное использование getMinValue и getMaxValue методы ColorSpace class), и альфа-компонент между 0.0 и 1.0. Если цвет или альфа-компонентные значения падают вне этих диапазонов, представляющие результаты неопределенны.

Методы, которые используют единственный международный пиксельный бросок представления IllegalArgumentException, если число компонентов для ComponentColorModel один, и компонентное значение без знака - другими словами, единственный компонент цвета, используя тип передачи DataBuffer.TYPE_BYTE, DataBuffer.TYPE_USHORT, или DataBuffer.TYPE_INT и никакая альфа.

A ComponentColorModel может использоваться в соединении с a ComponentSampleModel, a BandedSampleModel, или a PixelInterleavedSampleModel создать a BufferedImage.

См. Также:

ColorModel, ColorSpace, ComponentSampleModel, BandedSampleModel, PixelInterleavedSampleModel, BufferedImage

Полевая Сводка

Поля, наследованные от class java.awt.image. ColorModel

pixel_bits, transferType

Поля, наследованные от интерфейса java.awt. Прозрачность

BITMASK, OPAQUE, TRANSLUCENT

Сводка конструктора

Конструкторы

Конструктор и Описание
ComponentColorModel(ColorSpace colorSpace, boolean hasAlpha, boolean isAlphaPremultiplied, int transparency, int transferType) Конструкции a ComponentColorModel от указанных параметров.
ComponentColorModel(ColorSpace colorSpace, int[] bits, boolean hasAlpha, boolean isAlphaPremultiplied, int transparency, int transferType) Конструкции a ComponentColorModel от указанных параметров.

Сводка метода

Модификатор и Тип	Метод и Описание
ColorModel	coerceData(WritableRaster raster, boolean isAlphaPremultiplied) Вынуждает растровые данные соответствовать состояние, определенное в isAlphaPremultiplied переменная, принимая данные в настоящий момент правильно описывается этим ColorModel.
SampleModel	createCompatibleSampleModel(int w, int h) Создает a SampleModel с указанным width и height, у которого есть формат данных, совместимый с этим ColorModel.
WritableRaster	createCompatibleWritableRaster(int w, int h) Создает a WritableRaster с указанным width и height, у которого есть формат данных (SampleModel) совместимый с этим ColorModel.
boolean	equals(Object obj) Сравнивает эту цветовую модель с другим для равенства.
int	getAlpha(int pixel) Возвращает альфа-компонент для указанного пикселя, масштабируемого от 0 до 255.
int	getAlpha(Object inData) Возвращает альфа-компонент для указанного пикселя, масштабируемого от 0 до 255.
WritableRaster	getAlphaRaster(WritableRaster raster) Возвраты a Raster представление альфа-канала изображения, извлеченного из ввода Raster.
int	getBlue(int pixel) Возвращает синий компонент цвета для указанного пикселя, масштабируемого от 0 до 255 в RGB значения по умолчанию ColorSpace, sRGB.
int	getBlue(Object inData) Возвращает синий компонент цвета для указанного пикселя, масштабируемого от 0 до 255 в RGB значения по умолчанию ColorSpace, sRGB.
int[]	getComponents(int pixel, int[] components, int offset) Возвращает массив ненормализованных компонентов цвета/альфы, данных пиксель в этом ColorModel.
int[]	getComponents(Object pixel, int[] components, int offset) Возвращает массив ненормализованных компонентов цвета/альфы, данных пиксель в этом ColorModel.
int	getDataElement(float[] normComponents, int normOffset) Возвращает пиксельное значение, представленное как int в этом ColorModel, учитывая массив нормализованных компонентов цвета/альфы.
int	getDataElement(int[] components, int offset) Возвращает пиксельное значение, представленное как интервал в этом ColorModel, учитывая массив ненормализованных компонентов цвета/альфы.
Объект	getDataElements(float[] normComponents, int normOffset, Object obj) Возвращает представление в виде массива элемента данных пикселя в этом ColorModel, учитывая массив нормализованных компонентов цвета/альфы.
Объект	getDataElements(int[] components, int offset, Object obj) Возвращает представление в виде массива элемента данных пикселя в этом ColorModel, учитывая массив ненормализованных компонентов цвета/альфы.
Объект	getDataElements(int rgb, Object pixel) Возвращает представление в виде массива элемента данных пикселя в этом ColorModel, учитывая целочисленное пиксельное представление в цветовой модели RGB значения по умолчанию.
int	getGreen(int pixel) Возвращает зеленый компонент цвета для указанного пикселя, масштабируемого от 0 до 255 в RGB значения по умолчанию ColorSpace, sRGB.
int	getGreen(Object inData) Возвращает зеленый компонент цвета для указанного пикселя, масштабируемого от 0 до 255 в RGB значения по умолчанию ColorSpace, sRGB.
float[]	getNormalizedComponents(int[] components, int offset, float[] normComponents, int normOffset) Возвращает массив всех компонентов цвета/альфы в нормализованной форме, учитывая ненормализованный компонентный массив.
float[]	getNormalizedComponents(Object pixel, float[] normComponents, int normOffset) Возвращает массив всех компонентов цвета/альфы в нормализованной форме, учитывая пиксель в этом ColorModel.
int	getRed(int pixel) Возвращает красный компонент цвета для указанного пикселя, масштабируемого от 0 до 255 в RGB значения по умолчанию ColorSpace, sRGB.
int	getRed(Object inData) Возвращает красный компонент цвета для указанного пикселя, масштабируемого от 0 до 255 в RGB значения по умолчанию ColorSpace, sRGB.
int	getRGB(int pixel) Возвращает компоненты цвета/альфы пикселя в формате цветовой модели RGB значения по умолчанию.
int	getRGB(Object inData) Возвращает компоненты цвета/альфы для указанного пикселя в формате цветовой модели RGB значения по умолчанию.
int[]	getUnnormalizedComponents(float[] normComponents, int normOffset, int[] components, int offset) Возвращает массив всех компонентов цвета/альфы в ненормализованной форме, учитывая нормализованный компонентный массив.
boolean	isCompatibleRaster(Raster raster) Возвращает true если raster является совместимым с этим ColorModel; ложь, если это не.
boolean	isCompatibleSampleModel(SampleModel sm) Проверки, действительно ли указанное SampleModel является совместимым с этим ColorModel.

Методы, наследованные от class java.awt.image. ColorModel

finalize, getColorSpace, getComponentSize, getComponentSize, getNumColorComponents, getNumComponents, getPixelSize, getRGBdefault, getTransferType, getTransparency, hasAlpha, hashCode, isAlphaPremultiplied, toString

Методы, наследованные от class java.lang. Объект

clone, getClass, notify, notifyAll, wait, wait, wait

Деталь конструктора

ComponentColorModel

public ComponentColorModel(ColorSpace colorSpace,
                           int[] bits,
                           boolean hasAlpha,
                           boolean isAlphaPremultiplied,
                           int transparency,
                           int transferType)

Конструкции a ComponentColorModel от указанных параметров. Компоненты цвета будут в указанном ColorSpace. Поддерживаемые типы передачи DataBuffer.TYPE_BYTE, DataBuffer.TYPE_USHORT, DataBuffer.TYPE_INT, DataBuffer.TYPE_SHORT, DataBuffer.TYPE_FLOAT, и DataBuffer.TYPE_DOUBLE. Если не нуль, bits массив определяет число существенных битов на цвет и альфа-компонент, и его длина должна быть, по крайней мере, числом компонентов в ColorSpace если нет никакой информации об альфе в пиксельных значениях, или еще одного чем это число, если есть информация об альфе. Когда transferType DataBuffer.TYPE_SHORT, DataBuffer.TYPE_FLOAT, или DataBuffer.TYPE_DOUBLE bits параметр массива игнорируется. hasAlpha указывает, присутствует ли информация об альфе. Если hasAlpha истина, тогда булево isAlphaPremultiplied определяет, как интерпретировать цвет и альфа-выборки в пиксельных значениях. Если булево истинно, цветные выборки, как предполагается, были умножены на альфа-выборку. transparency определяет, какие альфа-значения могут быть представлены этой цветовой моделью. Приемлемое transparency значения OPAQUE, BITMASK или TRANSLUCENT. transferType тип примитивного массива, используемого, чтобы представить пиксельные значения.

Параметры:

colorSpace - ColorSpace связанный с этой цветовой моделью.

bits - Число существенных битов на компонент. Может быть нуль, когда все биты всех компонентных выборок будут существенными. Проигнорированный, если transferType является одним из DataBuffer.TYPE_SHORT, DataBuffer.TYPE_FLOAT, или DataBuffer.TYPE_DOUBLE, когда все биты всех компонентных выборок будут существенными.

hasAlpha - Если это правда, эта цветовая модель поддерживает альфу.

isAlphaPremultiplied - Если это правда, альфа предварительно умножается.

transparency - Определяет, какие альфа-значения могут быть представлены этой цветовой моделью.

transferType - Определяет тип примитивного массива, используемого, чтобы представить пиксельные значения.

Броски:

IllegalArgumentException - Если bits параметром массива не является нуль, его длина является меньше чем число цвета и альфа-компонентов, и transferType является одним из DataBuffer.TYPE_BYTE, DataBuffer.TYPE_USHORT, или DataBuffer.TYPE_INT.

IllegalArgumentException - Если transferType не является одним из DataBuffer.TYPE_BYTE, DataBuffer.TYPE_USHORT, DataBuffer.TYPE_INT, DataBuffer.TYPE_SHORT, DataBuffer.TYPE_FLOAT, или DataBuffer.TYPE_DOUBLE.

См. Также:

ColorSpace, Transparency

ComponentColorModel

public ComponentColorModel(ColorSpace colorSpace,
                           boolean hasAlpha,
                           boolean isAlphaPremultiplied,
                           int transparency,
                           int transferType)

Конструкции a ComponentColorModel от указанных параметров. Компоненты цвета будут в указанном ColorSpace. Поддерживаемые типы передачи DataBuffer.TYPE_BYTE, DataBuffer.TYPE_USHORT, DataBuffer.TYPE_INT, DataBuffer.TYPE_SHORT, DataBuffer.TYPE_FLOAT, и DataBuffer.TYPE_DOUBLE. Число существенных битов на цвет и альфа-компонент будет 8, 16, 32, 16, 32, или 64, соответственно. Число компонентов цвета будет числом компонентов в ColorSpace. Будет альфа-компонент если hasAlpha true. Если hasAlpha истина, тогда булево isAlphaPremultiplied определяет, как интерпретировать цвет и альфа-выборки в пиксельных значениях. Если булево истинно, цветные выборки, как предполагается, были умножены на альфа-выборку. transparency определяет, какие альфа-значения могут быть представлены этой цветовой моделью. Приемлемое transparency значения OPAQUE, BITMASK или TRANSLUCENT. transferType тип примитивного массива, используемого, чтобы представить пиксельные значения.

Параметры:

colorSpace - ColorSpace связанный с этой цветовой моделью.

hasAlpha - Если это правда, эта цветовая модель поддерживает альфу.

isAlphaPremultiplied - Если это правда, альфа предварительно умножается.

transparency - Определяет, какие альфа-значения могут быть представлены этой цветовой моделью.

transferType - Определяет тип примитивного массива, используемого, чтобы представить пиксельные значения.

Броски:

IllegalArgumentException - Если transferType не является одним из DataBuffer.TYPE_BYTE, DataBuffer.TYPE_USHORT, DataBuffer.TYPE_INT, DataBuffer.TYPE_SHORT, DataBuffer.TYPE_FLOAT, или DataBuffer.TYPE_DOUBLE.

С тех пор:

1.4

См. Также:

ColorSpace, Transparency

Деталь метода

getRed

public int getRed(int pixel)

Возвращает красный компонент цвета для указанного пикселя, масштабируемого от 0 до 255 в RGB значения по умолчанию ColorSpace, sRGB. Цветное преобразование делается в случае необходимости. Пиксельное значение определяется как интервал. Возвращенное значение будет не предварительно умноженным значением. Если альфа предварительно умножается, этот метод отделяет ее прежде, чем возвратить значение (если альфа-значение будет 0, то красное значение будет 0).

Определенный:

getRed в class ColorModel

Параметры:

pixel - Пиксель, от которого Вы хотите получить красный компонент цвета.

Возвраты:

Красный компонент цвета для указанного пикселя, как интервал.

Броски:

IllegalArgumentException - Если есть больше чем один компонент в этом ColorModel.

IllegalArgumentException - Если компонентное значение для этого ColorModel подписывается

getGreen

public int getGreen(int pixel)

Возвращает зеленый компонент цвета для указанного пикселя, масштабируемого от 0 до 255 в RGB значения по умолчанию ColorSpace, sRGB. Цветное преобразование делается в случае необходимости. Пиксельное значение определяется как интервал. Возвращенное значение будет не предварительно умноженным значением. Если альфа предварительно умножается, этот метод отделяет ее прежде, чем возвратить значение (если альфа-значение будет 0, то зеленое значение будет 0).

Определенный:

getGreen в class ColorModel

Параметры:

pixel - Пиксель, от которого Вы хотите получить зеленый компонент цвета.

Возвраты:

Зеленый компонент цвета для указанного пикселя, как интервал.

Броски:

IllegalArgumentException - Если есть больше чем один компонент в этом ColorModel.

IllegalArgumentException - Если компонентное значение для этого ColorModel подписывается

getBlue

public int getBlue(int pixel)

Возвращает синий компонент цвета для указанного пикселя, масштабируемого от 0 до 255 в RGB значения по умолчанию ColorSpace, sRGB. Цветное преобразование делается в случае необходимости. Пиксельное значение определяется как интервал. Возвращенное значение будет не предварительно умноженным значением. Если альфа предварительно умножается, этот метод отделяет ее прежде, чем возвратить значение (если альфа-значение будет 0, то синее значение будет 0).

Определенный:

getBlue в class ColorModel

Параметры:

pixel - Пиксель, от которого Вы хотите получить синий компонент цвета.

Возвраты:

Синий компонент цвета для указанного пикселя, как интервал.

Броски:

IllegalArgumentException - Если есть больше чем один компонент в этом ColorModel.

IllegalArgumentException - Если компонентное значение для этого ColorModel подписывается

getAlpha

public int getAlpha(int pixel)

Возвращает альфа-компонент для указанного пикселя, масштабируемого от 0 до 255. Пиксельное значение определяется как интервал.

Определенный:

getAlpha в class ColorModel

Параметры:

pixel - Пиксель, от которого Вы хотите получить альфа-компонент.

Возвраты:

Альфа-компонент для указанного пикселя, как интервал.

Броски:

IllegalArgumentException - Если есть больше чем один компонент в этом ColorModel.

IllegalArgumentException - Если компонентное значение для этого ColorModel подписывается

getRGB

public int getRGB(int pixel)

Возвращает компоненты цвета/альфы пикселя в формате цветовой модели RGB значения по умолчанию. Цветное преобразование делается в случае необходимости. Возвращенное значение будет в не предварительно умноженном формате. Если альфа предварительно умножается, этот метод делит ее из компонентов цвета (если альфа-значение будет 0, то значения цвета будут 0).

Переопределения:

getRGB в class ColorModel

Параметры:

pixel - Пиксель, от которого Вы хотите получить компоненты цвета/альфы.

Возвраты:

Компоненты цвета/альфы для указанного пикселя, как интервал.

Броски:

IllegalArgumentException - Если есть больше чем один компонент в этом ColorModel.

IllegalArgumentException - Если компонентное значение для этого ColorModel подписывается

См. Также:

ColorModel.getRGBdefault()

getRed

public int getRed(Object inData)

Возвращает красный компонент цвета для указанного пикселя, масштабируемого от 0 до 255 в RGB значения по умолчанию ColorSpace, sRGB. Цветное преобразование делается в случае необходимости. pixel значение определяется массивом элементов данных типа transferType переданный в как ссылка на объект. Возвращенное значение будет не предварительно умноженным значением. Если альфа предварительно умножается, этот метод отделяет ее прежде, чем возвратить значение (если альфа-значение будет 0, то красное значение будет 0). С тех пор ComponentColorModel может быть разделен на подклассы, подклассы наследовали реализацию этого метода и если они не переопределяют это тогда, они выдают исключение, если они используют неподдерживаемый transferType.

Переопределения:

getRed в class ColorModel

Параметры:

inData - Пиксель, от которого Вы хотите получить красный компонент цвета, определенный массивом элементов данных типа transferType.

Возвраты:

Красный компонент цвета для указанного пикселя, как интервал.

Броски:

ClassCastException - Если inData не примитивный массив типа transferType.

ArrayIndexOutOfBoundsException - если inData не является достаточно большим, чтобы содержать пиксельное значение для этого ColorModel.

UnsupportedOperationException - Если тип передачи этого ComponentColorModel не один из поддерживаемых типов передачи: DataBuffer.TYPE_BYTE, DataBuffer.TYPE_USHORT, DataBuffer.TYPE_INT, DataBuffer.TYPE_SHORT, DataBuffer.TYPE_FLOAT, или DataBuffer.TYPE_DOUBLE.

getGreen

public int getGreen(Object inData)

Возвращает зеленый компонент цвета для указанного пикселя, масштабируемого от 0 до 255 в RGB значения по умолчанию ColorSpace, sRGB. Цветное преобразование делается в случае необходимости. pixel значение определяется массивом элементов данных типа transferType переданный в как ссылка на объект. Возвращенное значение является не предварительно умноженным значением. Если альфа предварительно умножается, этот метод отделяет ее прежде, чем возвратить значение (если альфа-значение будет 0, то зеленое значение будет 0). С тех пор ComponentColorModel может быть разделен на подклассы, подклассы наследовали реализацию этого метода и если они не переопределяют это тогда, они выдают исключение, если они используют неподдерживаемый transferType.

Переопределения:

getGreen в class ColorModel

Параметры:

inData - Пиксель, от которого Вы хотите получить зеленый компонент цвета, определенный массивом элементов данных типа transferType.

Возвраты:

Зеленый компонент цвета для указанного пикселя, как интервал.

Броски:

ClassCastException - Если inData не примитивный массив типа transferType.

ArrayIndexOutOfBoundsException - если inData не является достаточно большим, чтобы содержать пиксельное значение для этого ColorModel.

UnsupportedOperationException - Если тип передачи этого ComponentColorModel не один из поддерживаемых типов передачи: DataBuffer.TYPE_BYTE, DataBuffer.TYPE_USHORT, DataBuffer.TYPE_INT, DataBuffer.TYPE_SHORT, DataBuffer.TYPE_FLOAT, или DataBuffer.TYPE_DOUBLE.

getBlue

public int getBlue(Object inData)

Возвращает синий компонент цвета для указанного пикселя, масштабируемого от 0 до 255 в RGB значения по умолчанию ColorSpace, sRGB. Цветное преобразование делается в случае необходимости. pixel значение определяется массивом элементов данных типа transferType переданный в как ссылка на объект. Возвращенное значение является не предварительно умноженным значением. Если альфа предварительно умножается, этот метод отделяет ее прежде, чем возвратить значение (если альфа-значение будет 0, то синее значение будет 0). С тех пор ComponentColorModel может быть разделен на подклассы, подклассы наследовали реализацию этого метода и если они не переопределяют это тогда, они выдают исключение, если они используют неподдерживаемый transferType.

Переопределения:

getBlue в class ColorModel

Параметры:

inData - Пиксель, от которого Вы хотите получить синий компонент цвета, определенный массивом элементов данных типа transferType.

Возвраты:

Синий компонент цвета для указанного пикселя, как интервал.

Броски:

ClassCastException - Если inData не примитивный массив типа transferType.

ArrayIndexOutOfBoundsException - если inData не является достаточно большим, чтобы содержать пиксельное значение для этого ColorModel.

UnsupportedOperationException - Если тип передачи этого ComponentColorModel не один из поддерживаемых типов передачи: DataBuffer.TYPE_BYTE, DataBuffer.TYPE_USHORT, DataBuffer.TYPE_INT, DataBuffer.TYPE_SHORT, DataBuffer.TYPE_FLOAT, или DataBuffer.TYPE_DOUBLE.

getAlpha

public int getAlpha(Object inData)

Возвращает альфа-компонент для указанного пикселя, масштабируемого от 0 до 255. Пиксельное значение определяется массивом элементов данных типа transferType переданный в как ссылка на объект. С тех пор ComponentColorModel может быть разделен на подклассы, подклассы наследовали реализацию этого метода и если они не переопределяют это тогда, они выдают исключение, если они используют неподдерживаемый transferType.

Переопределения:

getAlpha в class ColorModel

Параметры:

inData - Пиксель, от которого Вы хотите получить альфа-компонент, определенный массивом элементов данных типа transferType.

Возвраты:

Альфа-компонент для указанного пикселя, как интервал.

Броски:

ClassCastException - Если inData не примитивный массив типа transferType.

ArrayIndexOutOfBoundsException - если inData не является достаточно большим, чтобы содержать пиксельное значение для этого ColorModel.

UnsupportedOperationException - Если тип передачи этого ComponentColorModel не один из поддерживаемых типов передачи: DataBuffer.TYPE_BYTE, DataBuffer.TYPE_USHORT, DataBuffer.TYPE_INT, DataBuffer.TYPE_SHORT, DataBuffer.TYPE_FLOAT, или DataBuffer.TYPE_DOUBLE.

getRGB

public int getRGB(Object inData)

Возвращает компоненты цвета/альфы для указанного пикселя в формате цветовой модели RGB значения по умолчанию. Цветное преобразование делается в случае необходимости. Пиксельное значение определяется массивом элементов данных типа transferType переданный в как ссылка на объект. Возвращенное значение находится в не предварительно умноженном формате. Если альфа предварительно умножается, этот метод делит ее из компонентов цвета (если альфа-значение будет 0, то значения цвета будут 0). С тех пор ComponentColorModel может быть разделен на подклассы, подклассы наследовали реализацию этого метода и если они не переопределяют это тогда, они выдают исключение, если они используют неподдерживаемый transferType.

Переопределения:

getRGB в class ColorModel

Параметры:

inData - Пиксель, от которого Вы хотите получить компоненты цвета/альфы, определенные массивом элементов данных типа transferType.

Возвраты:

Компоненты цвета/альфы для указанного пикселя, как интервал.

Броски:

ClassCastException - Если inData не примитивный массив типа transferType.

ArrayIndexOutOfBoundsException - если inData не является достаточно большим, чтобы содержать пиксельное значение для этого ColorModel.

UnsupportedOperationException - Если тип передачи этого ComponentColorModel не один из поддерживаемых типов передачи: DataBuffer.TYPE_BYTE, DataBuffer.TYPE_USHORT, DataBuffer.TYPE_INT, DataBuffer.TYPE_SHORT, DataBuffer.TYPE_FLOAT, или DataBuffer.TYPE_DOUBLE.

См. Также:

ColorModel.getRGBdefault()

getDataElements

public Object getDataElements(int rgb,
                              Object pixel)

Возвращает представление в виде массива элемента данных пикселя в этом ColorModel, учитывая целочисленное пиксельное представление в цветовой модели RGB значения по умолчанию. Этот массив можно тогда передать к setDataElements метод a WritableRaster объект. Если pixel параметр является нулем, новый массив выделяется. С тех пор ComponentColorModel может быть разделен на подклассы, подклассы наследовали реализацию этого метода и если они не переопределяют это тогда, они выдают исключение, если они используют неподдерживаемый transferType.

Переопределения:

getDataElements в class ColorModel

Параметры:

rgb - целочисленное представление пикселя в цветовой модели RGB

pixel - указанный пиксель

Возвраты:

Представление в виде массива элемента данных пикселя в этом ColorModel.

Броски:

ClassCastException - Если pixel не нуль и не примитивный массив типа transferType.

ArrayIndexOutOfBoundsException - Если pixel не является достаточно большим, чтобы содержать пиксельное значение для этого ColorModel.

UnsupportedOperationException - Если тип передачи этого ComponentColorModel не один из поддерживаемых типов передачи: DataBuffer.TYPE_BYTE, DataBuffer.TYPE_USHORT, DataBuffer.TYPE_INT, DataBuffer.TYPE_SHORT, DataBuffer.TYPE_FLOAT, или DataBuffer.TYPE_DOUBLE.

См. Также:

WritableRaster.setDataElements(int, int, java.lang.Object), SampleModel.setDataElements(int, int, java.lang.Object, java.awt.image.DataBuffer)

getComponents

public int[] getComponents(int pixel,
                           int[] components,
                           int offset)

Возвращает массив ненормализованных компонентов цвета/альфы, данных пиксель в этом ColorModel. IllegalArgumentException бросается если компонентное значение для этого ColorModel не является удобно представимым в ненормализованной форме. Компоненты цвета/альфы сохранены в components массив, запускающийся в offset (даже если массив выделяется этим методом).

Переопределения:

getComponents в class ColorModel

Параметры:

pixel - Пиксельное значение, определенное как целое число.

components - Целочисленный массив, в котором можно сохранить ненормализованные компоненты цвета/альфы. Если components массив является нулем, новый массив выделяется.

offset - Смещение в components массив.

Возвраты:

Компонентный массив.

Броски:

IllegalArgumentException - Если есть больше чем один компонент в этом ColorModel.

IllegalArgumentException - Если это ColorModel не поддерживает ненормализованную форму

ArrayIndexOutOfBoundsException - Если components массив не является нулем и не является достаточно многочисленным, чтобы содержать весь цвет и альфа-компоненты (запускающийся при смещении).

getComponents

public int[] getComponents(Object pixel,
                           int[] components,
                           int offset)

Возвращает массив ненормализованных компонентов цвета/альфы, данных пиксель в этом ColorModel. Пиксельное значение определяется массивом элементов данных типа transferType переданный в как ссылка на объект. IllegalArgumentException бросается, если компонент оценивает за это ColorModel не являются удобно представимыми в ненормализованной форме. Компоненты цвета/альфы сохранены в components массив, запускающийся в offset (даже если массив выделяется этим методом). С тех пор ComponentColorModel может быть разделен на подклассы, подклассы наследовали реализацию этого метода и если они не переопределяют это тогда, этот метод мог бы выдать исключение, если они используют неподдерживаемый transferType.

Переопределения:

getComponents в class ColorModel

Параметры:

pixel - Пиксельное значение определяется массивом элементов данных типа transferType.

components - Целочисленный массив, в котором можно сохранить ненормализованные компоненты цвета/альфы. Если components массив является нулем, новый массив выделяется.

offset - Смещение в components массив.

Возвраты:

components массив.

Броски:

IllegalArgumentException - Если это ComponentColorModel не поддерживает ненормализованную форму

UnsupportedOperationException - в некоторых случаях эквивалентность тип передачи этого ComponentColorModel не один из следующих типов передачи: DataBuffer.TYPE_BYTE, DataBuffer.TYPE_USHORT, или DataBuffer.TYPE_INT.

ClassCastException - Если pixel не примитивный массив типа transferType.

IllegalArgumentException - Если components массив не является нулем и не является достаточно многочисленным, чтобы содержать весь цвет и альфа-компоненты (запускающийся при смещении), или если pixel не является достаточно большим, чтобы содержать пиксельное значение для этого ColorModel.

getUnnormalizedComponents

public int[] getUnnormalizedComponents(float[] normComponents,
                                       int normOffset,
                                       int[] components,
                                       int offset)

Возвращает массив всех компонентов цвета/альфы в ненормализованной форме, учитывая нормализованный компонентный массив. Ненормализованные компоненты являются интегральными значениями без знака между 0 и ²ⁿ - 1, где n является числом битов для определенного компонента. Нормализованные компоненты являются значениями плавающими между на компонентный минимум и максимум, определенный ColorSpace объект для этого ColorModel. IllegalArgumentException будет брошен, если компонент цвета оценит за это ColorModel не являются удобно представимыми в ненормализованной форме. Если components массив null, будет выделен новый массив. components массив будет возвращен. Компоненты цвета/альфы сохранены в components массив, запускающийся в offset (даже если массив выделяется этим методом). ArrayIndexOutOfBoundsException бросается если components массив не null и не является достаточно большим, чтобы содержать весь цвет и альфа-компоненты (запускающийся в offset). IllegalArgumentException бросается если normComponents массив не является достаточно многочисленным, чтобы содержать весь цвет и альфа-компоненты, запускающиеся в normOffset.

Переопределения:

getUnnormalizedComponents в class ColorModel

Параметры:

normComponents - массив, содержащий нормализованные компоненты

normOffset - смещение в normComponents массив, в котором можно начать получать нормализованные компоненты

components - массив, который получает компоненты из normComponents

offset - индексирование в components в котором можно начать хранить нормализованные компоненты от normComponents

Возвраты:

массив, содержащий ненормализованный цвет и альфа-компоненты.

Броски:

IllegalArgumentException - Если это ComponentColorModel не поддерживает ненормализованную форму

IllegalArgumentException - если длина normComponents минус normOffset меньше чем numComponents

getNormalizedComponents

public float[] getNormalizedComponents(int[] components,
                                       int offset,
                                       float[] normComponents,
                                       int normOffset)

Возвращает массив всех компонентов цвета/альфы в нормализованной форме, учитывая ненормализованный компонентный массив. Ненормализованные компоненты являются интегральными значениями без знака между 0 и ²ⁿ - 1, где n является числом битов для определенного компонента. Нормализованные компоненты являются значениями плавающими между на компонентный минимум и максимум, определенный ColorSpace объект для этого ColorModel. IllegalArgumentException будет брошен, если компонент цвета оценит за это ColorModel не являются удобно представимыми в ненормализованной форме. Если normComponents массив null, будет выделен новый массив. normComponents массив будет возвращен. Компоненты цвета/альфы сохранены в normComponents массив, запускающийся в normOffset (даже если массив выделяется этим методом). ArrayIndexOutOfBoundsException бросается если normComponents массив не null и не является достаточно большим, чтобы содержать весь цвет и альфа-компоненты (запускающийся в normOffset). IllegalArgumentException бросается если components массив не является достаточно многочисленным, чтобы содержать весь цвет и альфа-компоненты, запускающиеся в offset.

Переопределения:

getNormalizedComponents в class ColorModel

Параметры:

components - массив, содержащий ненормализованные компоненты

offset - смещение в components массив, в котором можно начать получать ненормализованные компоненты

normComponents - массив, который получает нормализованные компоненты

normOffset - индексирование в normComponents в котором можно начать хранить нормализованные компоненты

Возвраты:

массив, содержащий нормализованный цвет и альфа-компоненты.

Броски:

IllegalArgumentException - Если это ComponentColorModel не поддерживает ненормализованную форму

getDataElement

public int getDataElement(int[] components,
                          int offset)

Возвращает пиксельное значение, представленное как интервал в этом ColorModel, учитывая массив ненормализованных компонентов цвета/альфы.

Переопределения:

getDataElement в class ColorModel

Параметры:

components - Массив ненормализованных компонентов цвета/альфы.

offset - Смещение в components массив.

Возвраты:

Пиксельное значение, представленное как интервал.

Броски:

IllegalArgumentException - Если есть больше чем один компонент в этом ColorModel.

IllegalArgumentException - Если это ComponentColorModel не поддерживает ненормализованную форму

getDataElements

public Object getDataElements(int[] components,
                              int offset,
                              Object obj)

Возвращает представление в виде массива элемента данных пикселя в этом ColorModel, учитывая массив ненормализованных компонентов цвета/альфы. Этот массив можно тогда передать к setDataElements метод a WritableRaster объект.

Переопределения:

getDataElements в class ColorModel

Параметры:

components - Массив ненормализованных компонентов цвета/альфы.

offset - Целочисленное смещение в components массив.

obj - Объект, в котором можно сохранить представление в виде массива элемента данных пикселя. Если obj переменная является нулем, новый массив выделяется. Если obj не нуль, это должен быть примитивный массив типа transferType. ArrayIndexOutOfBoundsException бросается если obj не является достаточно большим, чтобы содержать пиксельное значение для этого ColorModel. С тех пор ComponentColorModel может быть разделен на подклассы, подклассы наследовали реализацию этого метода и если они не переопределяют это тогда, они выдают исключение, если они используют неподдерживаемый transferType.

Возвраты:

Представление в виде массива элемента данных пикселя в этом ColorModel.

Броски:

IllegalArgumentException - Если компонентный массив не является достаточно многочисленным, чтобы содержать весь цвет и альфа-компоненты (запускающийся при смещении).

ClassCastException - Если obj не нуль и не примитивный массив типа transferType.

ArrayIndexOutOfBoundsException - Если obj не является достаточно большим, чтобы содержать пиксельное значение для этого ColorModel.

IllegalArgumentException - Если это ComponentColorModel не поддерживает ненормализованную форму

UnsupportedOperationException - Если тип передачи этого ComponentColorModel не один из следующих типов передачи: DataBuffer.TYPE_BYTE, DataBuffer.TYPE_USHORT, или DataBuffer.TYPE_INT.

См. Также:

WritableRaster.setDataElements(int, int, java.lang.Object), SampleModel.setDataElements(int, int, java.lang.Object, java.awt.image.DataBuffer)

getDataElement

public int getDataElement(float[] normComponents,
                          int normOffset)

Возвращает пиксельное значение, представленное как int в этом ColorModel, учитывая массив нормализованных компонентов цвета/альфы. Этот метод бросит IllegalArgumentException если пиксельные значения для этого ColorModel не являются удобно представимыми как сингл int. ArrayIndexOutOfBoundsException бросается если normComponents массив не является достаточно многочисленным, чтобы содержать весь цвет и альфа-компоненты (запускающийся в normOffset).

Переопределения:

getDataElement в class ColorModel

Параметры:

normComponents - массив нормализованного цвета и альфа-компонентов

normOffset - индексирование в normComponents в котором можно начать получать альфа-компоненты и цвет

Возвраты:

int пиксельное значение в этом ColorModel соответствие указанным компонентам.

Броски:

IllegalArgumentException - если пиксельные значения для этого ColorModel не являются удобно представимыми как сингл int

ArrayIndexOutOfBoundsException - если normComponents массив не является достаточно многочисленным, чтобы содержать весь цвет и альфа-компоненты, запускающиеся в normOffset

С тех пор:

1.4

getDataElements

public Object getDataElements(float[] normComponents,
                              int normOffset,
                              Object obj)

Возвращает представление в виде массива элемента данных пикселя в этом ColorModel, учитывая массив нормализованных компонентов цвета/альфы. Этот массив можно тогда передать к setDataElements метод a WritableRaster объект. ArrayIndexOutOfBoundsException бросается если normComponents массив не является достаточно многочисленным, чтобы содержать весь цвет и альфа-компоненты (запускающийся в normOffset). Если obj переменная null, будет выделен новый массив. Если obj не null, это должен быть примитивный массив типа transferType; иначе, a ClassCastException бросается. ArrayIndexOutOfBoundsException бросается если obj не является достаточно большим, чтобы содержать пиксельное значение для этого ColorModel.

Переопределения:

getDataElements в class ColorModel

Параметры:

normComponents - массив нормализованного цвета и альфа-компонентов

normOffset - индексирование в normComponents в котором можно начать получать альфа-компоненты и цвет

obj - примитивный массив данных, чтобы содержать возвращенный пиксель

Возвраты:

Object который является примитивным представлением массива данных пикселя

Броски:

ClassCastException - если obj не примитивный массив типа transferType

ArrayIndexOutOfBoundsException - если obj не является достаточно большим, чтобы содержать пиксельное значение для этого ColorModel или normComponents массив не является достаточно многочисленным, чтобы содержать весь цвет и альфа-компоненты, запускающиеся в normOffset

С тех пор:

1.4

См. Также:

WritableRaster.setDataElements(int, int, java.lang.Object), SampleModel.setDataElements(int, int, java.lang.Object, java.awt.image.DataBuffer)

getNormalizedComponents

public float[] getNormalizedComponents(Object pixel,
                                       float[] normComponents,
                                       int normOffset)

Возвращает массив всех компонентов цвета/альфы в нормализованной форме, учитывая пиксель в этом ColorModel. Пиксельное значение определяется массивом элементов данных типа transferType, передал в как ссылка на объект. Если пиксель не является примитивным массивом типа transferType, a ClassCastException бросается. ArrayIndexOutOfBoundsException бросается если pixel не является достаточно большим, чтобы содержать пиксельное значение для этого ColorModel. Нормализованные компоненты являются значениями плавающими между на компонентный минимум и максимум, определенный ColorSpace объект для этого ColorModel. Если normComponents массив null, будет выделен новый массив. normComponents массив будет возвращен. Компоненты цвета/альфы сохранены в normComponents массив, запускающийся в normOffset (даже если массив выделяется этим методом). ArrayIndexOutOfBoundsException бросается если normComponents массив не null и не является достаточно большим, чтобы содержать весь цвет и альфа-компоненты (запускающийся в normOffset).

Этот метод должен быть overrridden подклассом, если тот подкласс разрабатывается, чтобы преобразовать пиксельные демонстрационные значения в значения компонента цвета способом не по умолчанию. Преобразования значения по умолчанию, реализованные этим class, описываются в комментариях class. Любой подкласс, реализовывая преобразование не по умолчанию должен следовать за ограничениями на допустимые преобразования, определенные там.

Переопределения:

getNormalizedComponents в class ColorModel

Параметры:

pixel - указанный пиксель

normComponents - массив, чтобы получить нормализованные компоненты

normOffset - смещение в normComponents массив, в котором можно начать хранить нормализованные компоненты

Возвраты:

массив, содержащий нормализованный цвет и альфа-компоненты.

Броски:

ClassCastException - если pixel не примитивный массив типа transferType

ArrayIndexOutOfBoundsException - если normComponents не является достаточно большим, чтобы содержать весь цвет и альфа-компоненты, запускающиеся в normOffset

ArrayIndexOutOfBoundsException - если pixel не является достаточно большим, чтобы содержать пиксельное значение для этого ColorModel.

С тех пор:

1.4

coerceData

public ColorModel coerceData(WritableRaster raster,
                             boolean isAlphaPremultiplied)

Вынуждает растровые данные соответствовать состояние, определенное в isAlphaPremultiplied переменная, принимая данные в настоящий момент правильно описывается этим ColorModel. Это может умножить или разделить цветные растровые данные на альфу, или ничего не сделать, если данные находятся в корректном состоянии. Если данные должны быть принуждены, этот метод также возвращает экземпляр этого ColorModel с isAlphaPremultiplied набор флага соответственно. С тех пор ColorModel может быть разделен на подклассы, подклассы наследовали реализацию этого метода и если они не переопределяют это тогда, они выдают исключение, если они используют неподдерживаемый transferType.

Переопределения:

coerceData в class ColorModel

Параметры:

raster - WritableRaster данные

isAlphaPremultiplied - true если альфа предварительно умножается; false иначе

Возвраты:

a ColorModel объект, который представляет принужденные данные.

Броски:

NullPointerException - если raster null и приведение данных требуется.

UnsupportedOperationException - если тип передачи этого ComponentColorModel не один из поддерживаемых типов передачи: DataBuffer.TYPE_BYTE, DataBuffer.TYPE_USHORT, DataBuffer.TYPE_INT, DataBuffer.TYPE_SHORT, DataBuffer.TYPE_FLOAT, или DataBuffer.TYPE_DOUBLE.

isCompatibleRaster

public boolean isCompatibleRaster(Raster raster)

Возвращает true если raster является совместимым с этим ColorModel; ложь, если это не.

Переопределения:

isCompatibleRaster в class ColorModel

Параметры:

raster - Raster возразите, чтобы протестировать на совместимость.

Возвраты:

true если raster является совместимым с этим ColorModel, false если это не.

createCompatibleWritableRaster

public WritableRaster createCompatibleWritableRaster(int w,
                                                     int h)

Создает a WritableRaster с указанным width и height, у которого есть формат данных (SampleModel) совместимый с этим ColorModel.

Переопределения:

createCompatibleWritableRaster в class ColorModel

Параметры:

w - width WritableRaster Вы хотите создать.

h - height WritableRaster Вы хотите создать.

Возвраты:

A WritableRaster это является совместимым с этим ColorModel.

См. Также:

WritableRaster, SampleModel

createCompatibleSampleModel

public SampleModel createCompatibleSampleModel(int w,
                                               int h)

Создает a SampleModel с указанным width и height, у которого есть формат данных, совместимый с этим ColorModel.

Переопределения:

createCompatibleSampleModel в class ColorModel

Параметры:

w - width SampleModel Вы хотите создать.

h - height SampleModel Вы хотите создать.

Возвраты:

A SampleModel это является совместимым с этим ColorModel.

См. Также:

SampleModel

isCompatibleSampleModel

public boolean isCompatibleSampleModel(SampleModel sm)

Проверки, действительно ли указанное SampleModel является совместимым с этим ColorModel.

Переопределения:

isCompatibleSampleModel в class ColorModel

Параметры:

sm - SampleModel протестировать на совместимость.

Возвраты:

true если SampleModel является совместимым с этим ColorModel, false если это не.

См. Также:

SampleModel

getAlphaRaster

public WritableRaster getAlphaRaster(WritableRaster raster)

Возвраты a Raster представление альфа-канала изображения, извлеченного из ввода Raster. Этот метод принимает это Raster объекты связались с этим ColorModel сохраните альфа-полосу, если есть как последняя полоса данных изображения. Нуль возвратов, если нет никакого отдельного пространственного альфа-канала, связанного с этим ColorModel. Этот метод создает новое Raster, но совместно использует массив данных.

Переопределения:

getAlphaRaster в class ColorModel

Параметры:

raster - WritableRaster из которого можно извлечь альфа-канал.

Возвраты:

A WritableRaster содержа альфа-канал изображения.

равняется

public boolean equals(Object obj)

Сравнивает эту цветовую модель с другим для равенства.

Переопределения:

equals в class ColorModel

Параметры:

obj - Объект сравниться с этой цветовой моделью.

Возвраты:

true если объекты цветовой модели равны, false если они не.

См. Также:

Object.hashCode(), HashMap