Класс ColorConvertOp

java.lang.Object

java.awt.image.ColorConvertOp

Все реализованные интерфейсы:: BufferedImageOp, RasterOp

public class ColorConvertOp extends Object implements BufferedImageOp, RasterOp

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

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

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

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

См. также:

Краткое описание конструкторов

Конструктор	Описание
`ColorConvertOp(ColorSpace srcCspace, ColorSpace dstCspace, RenderingHints hints)`	Создает новый ColorConvertOp из двух объектов ColorSpace.
`ColorConvertOp(ColorSpace cspace, RenderingHints hints)`	Создает новый ColorConvertOp из объекта ColorSpace.
`ColorConvertOp(ICC_Profile[] profiles, RenderingHints hints)`	Создает новый ColorConvertOp из массива объектов ICC_Profiles.
`ColorConvertOp(RenderingHints hints)`	Создает новый ColorConvertOp, который будет преобразовывать из исходного цветового пространства в целевое цветовое пространство.

Краткое описание методов

Модификатор и тип	Метод	Описание
`BufferedImage`	`createCompatibleDestImage(BufferedImage src, ColorModel destCM)`	Создает нулевое целевое изображение с правильным размером и количеством каналов, исходя из этого источника.
`WritableRaster`	`createCompatibleDestRaster(Raster src)`	Создает нулевой целевой Raster с правильным размером и количеством каналов, исходя из этого источника.
`final BufferedImage`	`filter(BufferedImage src, BufferedImage dest)`	Преобразует исходный BufferedImage.
`final WritableRaster`	`filter(Raster src, WritableRaster dest)`	Преобразует данные изображения в исходном Raster.
`final Rectangle2D`	`getBounds2D(BufferedImage src)`	Возвращает область обрезки целевого изображения, исходя из этого источника.
`final Rectangle2D`	`getBounds2D(Raster src)`	Возвращает область обрезки целевого изображения, исходя из этого источника.
`final ICC_Profile[]`	`getICC_Profiles()`	Возвращает массив ICC_Profiles, используемых для создания этого ColorConvertOp.
`final Point2D`	`getPoint2D(Point2D srcPt, Point2D dstPt)`	Возвращает расположение точки назначения, учитывая точку в источнике.
`final RenderingHints`	`getRenderingHints()`	Возвращает используемые этим методом настройки рендеринга.

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробное описание конструкторов

ColorConvertOp

public ColorConvertOp(RenderingHints hints)

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

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

ColorConvertOp

public ColorConvertOp(ColorSpace cspace, RenderingHints hints)

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

Параметры:: srcCspace - исходное ColorSpace; dstCspace - целевое ColorSpace; hints - объект RenderingHints, используемый для управления преобразованием цветов, или null
Исключения:: NullPointerException - если srcCspace или dstCspace равно null

ColorConvertOp

public ColorConvertOp(ICC_Profile[] profiles, RenderingHints hints)

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

Для BufferedImages, если цветовое пространство исходного BufferedImage не соответствует требованиям первого профиля в массиве, первое преобразование выполняется в соответствующее цветовое пространство. Если требования последнего профиля в массиве не соответствуют цветовому пространству целевого BufferedImage, последнее преобразование выполняется в цветовое пространство назначения.

Для Rasters количество каналов в исходном Raster должно соответствовать требованиям первого профиля в массиве, а количество каналов в целевом Raster должно соответствовать требованиям последнего профиля в массиве. Массив должен содержать по крайней мере два элемента, иначе вызов метода filter для Rasters вызовет IllegalArgumentException.

Параметры:: 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. Количество каналов в исходном и целевом Rasters должно соответствовать требованиям, описанным выше. Конструктор, использованный для создания этого 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 WritableRaster с правильным размером и количеством каналов из указанного 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()

Возвращает параметры визуализации, используемые этим оператором.

Указано в:: getRenderingHints в интерфейсе BufferedImageOp
Указано в:: getRenderingHints в интерфейсе RasterOp
Возвращает:: объект RenderingHints этого ColorConvertOp

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/awt/image/ColorConvertOp.html