Класс PackedColorModel

public abstract class PackedColorModel
extends ColorModel

Класс PackedColorModel — это абстрактный класс ColorModel, который работает с значениями пикселей, представляющими информацию о цвете и альфа-канале как отдельные образцы и упаковывающие все образцы для одного пикселя в одно целое число, короткое целое или байт. Этот класс может использоваться с произвольным ColorSpace. Количество цветовых образцов в значениях пикселей должно быть таким же, как количество цветовых компонентов в ColorSpace. Может быть один образец альфа-канала. Длина массива всегда равна 1 для тех методов, которые используют примитивный массив пикселей типа transferType. Поддерживаемые типы преобразования — DataBuffer.TYPE_BYTE, DataBuffer.TYPE_USHORT и DataBuffer.TYPE_INT. Цветовые и альфа-образцы хранятся в единственном элементе массива в битах, указанных масками. Каждая маска должна быть непрерывной, и маски не должны перекрываться. Те же маски применяются к представлению единственного пикселя в виде целого числа, используемому другими методами. Соответствие масок и цветовых/альфа-образцов таково:

• Маски идентифицируются индексами, которые пробегают от 0 до getNumComponents - 1.
• Первые getNumColorComponents индексы относятся к цветовым образцам.
• Если присутствует образец альфа-канала, он соответствует последнему индексу.
• Порядок цветовых индексов задается ColorSpace. Как правило, это отражает название типа цветового пространства (например, TYPE_RGB), индекс 0 соответствует красному, индекс 1 — зелёному, а индекс 2 — синему.

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

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

Подклассом PackedColorModel является DirectColorModel, который похож на X11 TrueColor визуал.

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

PackedColorModel

public PackedColorModel(ColorSpace space,
                        int bits,
                        int[] colorMaskArray,
                        int alphaMask,
                        boolean isAlphaPremultiplied,
                        int trans,
                        int transferType)

Создаёт PackedColorModel по массиву масок цветов, который определяет, какие биты в представлении пикселя содержат каждый из цветовых образцов, и маску альфа-канала. Цветовые компоненты находятся в указанном ColorSpace. Длина colorMaskArray должна соответствовать количеству компонентов в ColorSpace. Все биты в каждой маске должны быть смежными и помещаться в указанном количестве младших битов представления пикселя int. Если alphaMask равно 0, альфа-канал отсутствует. Если альфа-канал присутствует, то boolean isAlphaPremultiplied определяет, как интерпретировать цветовые и альфа-образцы в значениях пикселей. Если boolean равно true, считается, что цветовые образцы умножены на альфа-образец. Прозрачность, trans, указывает, какие значения альфа могут быть представлены этой цветовой моделью. Тип передачи — тип примитивного массива, используемого для представления значений пикселей.

Параметры:

space - указанное ColorSpace

bits - количество битов в значениях пикселей

colorMaskArray - массив, определяющий маски, представляющие биты значений пикселей, которые представляют цветовые компоненты

alphaMask - определяет маску, представляющую биты значений пикселей, которые представляют альфа-компонент

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

trans - определяет значение альфа, которое может быть представлено этой цветовой моделью

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

Исключения:

IllegalArgumentException - если bits меньше 1 или больше 32

PackedColorModel

public PackedColorModel(ColorSpace space,
                        int bits,
                        int rmask,
                        int gmask,
                        int bmask,
                        int amask,
                        boolean isAlphaPremultiplied,
                        int trans,
                        int transferType)

Создаёт PackedColorModel по указанным маскам, которые указывают, какие биты в представлении пикселя int содержат альфа-канал, красные, зелёные и синие цветовые образцы. Цветовые компоненты находятся в указанном ColorSpace, который должен быть типа ColorSpace.TYPE_RGB. Все биты в каждой маске должны быть смежными и помещаться в указанном количестве младших битов представления пикселя int. Если amask равно 0, альфа-канал отсутствует. Если альфа-канал присутствует, то boolean isAlphaPremultiplied определяет, как интерпретировать цветовые и альфа-образцы в значениях пикселей. Если boolean равно true, считается, что цветовые образцы умножены на альфа-образец. Прозрачность, trans, указывает, какие значения альфа могут быть представлены этой цветовой моделью. Тип передачи — тип примитивного массива, используемого для представления значений пикселей.

Параметры:

space - указанное ColorSpace

bits - количество битов в значениях пикселей

rmask - определяет маску, представляющую биты значений пикселей, которые представляют красный цветовой компонент

gmask - определяет маску, представляющую биты значений пикселей, которые представляют зелёный цветовой компонент

bmask - определяет маску, представляющую биты значений пикселей, которые представляют синий цветовой компонент

amask - определяет маску, представляющую биты значений пикселей, которые представляют альфа-компонент

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

trans - определяет значение альфа, которое может быть представлено этой цветовой моделью

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

Исключения:

IllegalArgumentException - если space не является пространством TYPE_RGB

См. также:

ColorSpace

Методы

getMask

public final int getMask(int index)

Возвращает маску, указывающую, какие биты в пикселе содержат указанный цветовой/альфа-образец. Для цветовых образцов index соответствует расположению имён цветовых образцов в цветовом пространстве. Таким образом, index равное 0 для CMYK ColorSpace соответствует Цвета и index равное 1 соответствует Мадженте. Если есть альфа-канал, альфа-маска index будет:

alphaIndex = numComponents() - 1;

Параметры:

index - указанный цветовой или альфа-образец

Возвращает:

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

Исключения:

ArrayIndexOutOfBoundsException - если index больше, чем количество компонентов минус 1 в этом PackedColorModel или если index меньше нуля

getMasks

public final int[] getMasks()

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

Возвращает:

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

createCompatibleSampleModel

public SampleModel createCompatibleSampleModel(int w,
                                               int h)

Создаёт SampleModel с указанной шириной и высотой, имеющей структуру данных, совместимую с этим ColorModel.

Переопределяет:

createCompatibleSampleModel в классе ColorModel

Параметры:

w - ширина (в пикселях) области данных изображения, описываемых

h - высота (в пикселях) области данных изображения, описываемых

Возвращает:

созданный SampleModel.

Исключения:

IllegalArgumentException - если w или h не больше 0

См. также:

SampleModel

isCompatibleSampleModel

public boolean isCompatibleSampleModel(SampleModel sm)

Проверяет, совместима ли указанная SampleModel с этим ColorModel. Если sm равно null, этот метод возвращает false.

Переопределяет:

isCompatibleSampleModel в классе ColorModel

Параметры:

sm - указанная SampleModel, или null

Возвращает:

true если указанная SampleModel совместима с этим ColorModel; false в противном случае.

См. также:

SampleModel

getAlphaRaster

public WritableRaster getAlphaRaster(WritableRaster raster)

Возвращает WritableRaster, представляющий альфа-канал изображения, извлечённый из входного WritableRaster. Этот метод предполагает, что объекты WritableRaster, связанные с этим ColorModel хранят полосу альфа, если она присутствует, как последнюю полосу данных изображения. Возвращает null если нет отдельного пространственного альфа-канала, связанного с этим ColorModel . Этот метод создаёт новый WritableRaster, но разделяет массив данных.

Переопределяет:

getAlphaRaster в классе ColorModel

Параметры:

raster - WritableRaster содержащий изображение

Возвращает:

WritableRaster представляющий альфа-канал изображения, содержащегося в raster.

equals

public boolean equals(Object obj)

Проверяет, является ли указанный Object экземпляром PackedColorModel и равен ли этому PackedColorModel.

Переопределяет:

equals в классе ColorModel

Параметры:

obj - Object для проверки на равенство

Возвращает:

true если указанный Object является экземпляром PackedColorModel и равен этому PackedColorModel; false в противном случае.

См. также:

Object.hashCode(), HashMap