Класс ColorConvertOp

public class ColorConvertOp
extends Object
implements BufferedImageOp, RasterOp

Этот класс выполняет преобразование цвета по пикселям данных в исходном изображении. Результирующие значения цвета масштабируются до точности целевого изображения. Преобразование цвета может быть задано массивом объектов ColorSpace или массивом объектов ICC_Profile.

Если исходное изображение BufferedImage имеет предварительно умноженный альфа-канал, компоненты цвета делятся на альфа-компонент перед преобразованием цвета. Если целевое изображение BufferedImage имеет предварительно умноженный альфа-канал, компоненты цвета умножаются на альфа-компонент после преобразования. Растры рассматриваются как не имеющие альфа-канала, т.е. все каналы являются каналами цвета.

Если в конструкторе указан объект RenderingHints, то атрибут рендеринга цвета и атрибут дithering могут быть использованы для управления преобразованием цвета.

Обратите внимание, что источник и цель могут быть одним и тем же объектом.

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

ColorConvertOp

public ColorConvertOp(RenderingHints hints)

Создаёт новый ColorConvertOp, который будет преобразовывать из исходного цветового пространства в целевое цветовое пространство. Аргумент RenderingHints может быть null. Этот Op может быть использован только с BufferedImages и будет преобразовывать напрямую из цветового пространства исходного изображения в цветовое пространство целевого. Целевой аргумент метода filter не может быть задан как null.

Параметры:

hints - объект RenderingHints, используемый для управления преобразованием цвета, или null

ColorConvertOp

public ColorConvertOp(ColorSpace cspace,
                      RenderingHints hints)

Создаёт новый ColorConvertOp из объекта ColorSpace. Аргумент RenderingHints может быть null. Этот Op может быть использован только с BufferedImages и в основном полезен, когда метод filter вызывается с целевым аргументом null. В этом случае ColorSpace определяет целевое цветовое пространство для целевого изображения, созданного методом filter. В противном случае ColorSpace определяет промежуточное пространство, в которое преобразуется исходное изображение перед преобразованием в целевое пространство.

Параметры:

cspace - определяет целевое ColorSpace или промежуточное ColorSpace

hints - объект RenderingHints, используемый для управления преобразованием цвета, или null

Исключения:

NullPointerException - если cspace равно null

ColorConvertOp

public ColorConvertOp(ColorSpace srcCspace,
                      ColorSpace dstCspace,
                      RenderingHints hints)

Создаёт новый ColorConvertOp из двух объектов ColorSpace. Аргумент RenderingHints может быть null. Этот Op в основном полезен для вызова метода filter для Rasters, в этом случае два ColorSpace определяют операцию, которая должна быть выполнена над Rasters. В этом случае количество каналов в исходном Raster должно соответствовать количеству компонентов в srcCspace, а количество каналов в целевом Raster должно соответствовать количеству компонентов в dstCspace. Для BufferedImages два ColorSpace определяют промежуточные пространства, через которые исходное изображение преобразуется перед преобразованием в целевое пространство.

Параметры:

srcCspace - исходное ColorSpace

dstCspace - целевое ColorSpace

hints - объект RenderingHints, используемый для управления преобразованием цвета, или null

Исключения:

NullPointerException - если srcCspace или dstCspace равно null

ColorConvertOp

public ColorConvertOp(ICC_Profile[] profiles,
                      RenderingHints hints)

Параметры:

profiles - массив объектов ICC_Profile

hints - объект RenderingHints, используемый для управления преобразованием цвета, или null

Исключения:

IllegalArgumentException - когда последовательность профилей не определяет хорошо определённое преобразование цвета

NullPointerException - если profiles равно null

Методы

getICC_Profiles

public final ICC_Profile[] getICC_Profiles()

Возвращает массив ICC_Profiles, используемых для создания этого ColorConvertOp. Возвращает null, если ColorConvertOp не был создан из такого массива.

Возвращает:

массив объектов ICC_Profile этого ColorConvertOp, или null если этот ColorConvertOp не был создан с массивом объектов ICC_Profile.

filter

public final BufferedImage filter(BufferedImage src,
                                  BufferedImage dest)

Преобразует исходное изображение BufferedImage. Если целевое изображение null, будет создано BufferedImage с соответствующим ColorModel.

Определено в:

filter в интерфейсе BufferedImageOp

Параметры:

src - исходное BufferedImage для преобразования

dest - целевое BufferedImage, или null

Возвращает:

dest преобразованное из src или новое, преобразованное BufferedImage если dest равно null

Исключения:

IllegalArgumentException - если dest равно null, и этот op был создан с помощью конструктора, принимающего только аргумент RenderingHints, так как операция не определена.

filter

public final WritableRaster filter(Raster src,
                                   WritableRaster dest)

Преобразует данные изображения в исходном Raster. Если целевой Raster равен null, будет создан новый Raster. Количество каналов в исходном и целевом Raster должно соответствовать вышеуказанным требованиям. Конструктор, используемый для создания этого ColorConvertOp, должен предоставить достаточную информацию для определения цветовых пространств как исходного, так и целевого. См. выше. В противном случае вызывается исключение.

Определено в:

filter в интерфейсе RasterOp

Параметры:

src - исходный Raster для преобразования

dest - целевой WritableRaster, или null

Возвращает:

dest преобразованное из src или новое, преобразованное WritableRaster если dest равно null

Исключения:

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

getBounds2D

public final Rectangle2D getBounds2D(BufferedImage src)

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

Определено в:

getBounds2D в интерфейсе BufferedImageOp

Параметры:

src - исходное BufferedImage

Возвращает:

прямоугольник Rectangle2D, являющийся прямоугольником, ограничивающим целевое изображение, заданный указанным src

getBounds2D

public final Rectangle2D getBounds2D(Raster src)

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

Определено в:

getBounds2D в интерфейсе RasterOp

Параметры:

src - исходный Raster

Возвращает:

прямоугольник Rectangle2D, являющийся прямоугольником, ограничивающим целевое изображение, заданный указанным src

createCompatibleDestImage

public BufferedImage createCompatibleDestImage(BufferedImage src,
                                               ColorModel destCM)

Создаёт нулевое целевое изображение с правильным размером и количеством каналов, заданным исходным изображением.

Определено в:

createCompatibleDestImage в интерфейсе BufferedImageOp

Параметры:

src - Исходное изображение для операции фильтрации.

destCM - ColorModel целевого изображения. Если null, будет использоваться соответствующий ColorModel.

Возвращает:

BufferedImage с правильным размером и количеством каналов из указанного src.

Исключения:

IllegalArgumentException - если destCM равно null и этот ColorConvertOp был создан без каких-либо ICC_Profile или ColorSpace для целевого изображения

createCompatibleDestRaster

public WritableRaster createCompatibleDestRaster(Raster src)

Создаёт нулевой целевой Raster с правильным размером и количеством каналов, заданным исходным изображением.

Определено в:

createCompatibleDestRaster в интерфейсе RasterOp

Параметры:

src - указанное Raster

Возвращает:

Raster с правильным размером и количеством каналов из указанного src

Исключения:

IllegalArgumentException - если этот ColorConvertOp был создан без достаточной информации для определения цветовых пространств dst и src

getPoint2D

public final Point2D getPoint2D(Point2D srcPt,
                                Point2D dstPt)

Возвращает положение целевой точки, заданной точкой в исходном изображении. Если dstPt не null, он будет использован для хранения возвращаемого значения. Обратите внимание, что для данного класса целевая точка будет такой же, как и исходная точка.

Определено в:

getPoint2D в интерфейсе BufferedImageOp

Определено в:

getPoint2D в интерфейсе RasterOp

Параметры:

srcPt - указанная исходная Point2D

dstPt - целевая Point2D

Возвращает:

dstPt после установки его местоположения таким же, как у srcPt

getRenderingHints

public final RenderingHints getRenderingHints()

Возвращает используемые этим op параметры рендеринга.

Определено в:

getRenderingHints в интерфейсе BufferedImageOp

Определено в:

getRenderingHints в интерфейсе RasterOp

Возвращает:

объект RenderingHints этого ColorConvertOp