Класс 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. Если цветовые или альфа-компоненты выходят за эти диапазоны, результаты отображения неопределённы.

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

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