Класс DirectColorModel

public class DirectColorModel extends PackedColorModel

Класс DirectColorModel — это класс, работающий с пиксельными значениями, которые представляют информацию о цвете RGB и альфа-канале как отдельные образцы и упаковывающие все образцы для одного пикселя в одно целое число, короткое целое число или байт. Этот класс может использоваться только с цветовыми пространствами типа ColorSpace.TYPE_RGB. Кроме того, для каждого компонента цветового пространства минимальное нормализованное значение компонента, полученное с помощью метода getMinValue() класса ColorSpace, должно быть 0,0, а максимальное значение, полученное с помощью метода getMaxValue(), должно быть 1,0 (эти минимальные/максимальные значения типичны для цветовых пространств RGB). В пиксельных значениях должно быть три образца цвета и может быть один образец альфа-канала. Для методов, использующих примитивный массив пикселей типа transferType, длина массива всегда равна одному. Поддерживаемые типы преобразования — DataBuffer.TYPE_BYTE, DataBuffer.TYPE_USHORT и DataBuffer.TYPE_INT. Образцы цвета и альфа-канала хранятся в единственном элементе массива в битах, указанных масками. Каждая маска должна быть непрерывной и маски не должны перекрываться. Те же маски применяются к представлению одного пикселя в виде целого числа, используемому другими методами. Соответствие масок и образцов цвета/альфа-канала таково:

• Маски идентифицируются индексами от 0 до 2, если альфа-канал отсутствует, или до 3, если альфа-канал присутствует.
• Первые три индекса относятся к образцам цвета; индекс 0 соответствует красному, индекс 1 — зеленому, а индекс 2 — синему.
• Индекс 3 соответствует образцу альфа-канала, если он присутствует.

Перевод из пиксельных значений в цветовые/альфа-компоненты для отображения или обработки представляет собой взаимно однозначное соответствие образцов компонентам. DirectColorModel обычно используется с данными изображения, которые используют маски для определения упакованных образцов. Например, DirectColorModel можно использовать совместно с SinglePixelPackedSampleModel для построения BufferedImage. Обычно маски, используемые SampleModel и ColorModel, совпадают. Однако, если они отличаются, интерпретация цвета пиксельных данных будет выполняться в соответствии с масками ColorModel.

Представление одного пикселя в виде целого числа является допустимым для всех объектов этого класса, так как всегда можно представить пиксельные значения, используемые с этим классом, в виде одного целого числа. Поэтому методы, использующие это представление, не будут выбрасывать IllegalArgumentException из-за некорректного пиксельного значения.

Эта цветовая модель похожа на визуальный элемент X11 TrueColor. По умолчанию цветовая модель RGB, указанная методом getRGBdefault, является DirectColorModel со следующими параметрами:

 Number of bits:        32
 Red mask:              0x00ff0000
 Green mask:            0x0000ff00
 Blue mask:             0x000000ff
 Alpha mask:            0xff000000
 Color space:           sRGB
 isAlphaPremultiplied:  False
 Transparency:          Transparency.TRANSLUCENT
 transferType:          DataBuffer.TYPE_INT
 

Многие методы в этом классе являются final. Это связано с тем, что базовый код графики с нативным API делает предположения о расположении и работе этого класса, и эти предположения отражаются в реализациях помеченных как final методов здесь. Вы можете создать подкласс этого класса по другим причинам, но вы не можете переопределять или изменять поведение этих методов.