Класс ComponentColorModel

Для методов, использующих примитивный массив пикселей типа 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). Подкласс может переопределить масштабирование для значений образцов short в нормализованные значения компонентов, переопределив метод 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.