Класс ComponentColorModel

public class ComponentColorModel
extends ColorModel

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

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

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

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

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

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

Экземпляры 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) форма конструктора с одним из этих типов преобразования, аргумент массива bits игнорируется.

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

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

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