Класс ColorConvertOp

java.lang.Object

java.awt.image.ColorConvertOp

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

public class ColorConvertOp extends Object implements BufferedImageOp, RasterOp

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

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

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

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

См. также:

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

Конструктор	Описание
`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)`	Создает нулевой растр назначения правильного размера и с правильным числом полос на основе заданного источника.
`final BufferedImage`	`filter(BufferedImage src, BufferedImage dest)`	Выполняет преобразование цвета исходного BufferedImage.
`final WritableRaster`	`filter(Raster src, WritableRaster dest)`	Выполняет преобразование цвета данных изображения в исходном растре.
`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()`	Возвращает подсказки по визуализации, используемые этой операцией.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли этот объект какому-либо другому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API может быть удален в будущей версии. Финализация объявлена устаревшей и будет удалена в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Переводит текущий поток в состояние ожидания, пока он не будет разбужен, обычно посредством вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Переводит текущий поток в состояние ожидания, пока он не будет разбужен, обычно посредством вызова notify или interrupt, либо пока не истечет заданный промежуток реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Переводит текущий поток в состояние ожидания, пока он не будет разбужен, обычно посредством вызова notify или interrupt, либо пока не истечет заданный промежуток реального времени.

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

ColorConvertOp

public ColorConvertOp(RenderingHints hints)

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

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

ColorConvertOp

public ColorConvertOp(ColorSpace cspace, RenderingHints hints)

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

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

ColorConvertOp

public ColorConvertOp(ICC_Profile[] profiles, RenderingHints hints)

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

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

Для растров число полос исходного растра должно соответствовать требованиям первого профиля в массиве, а число полос растра назначения — требованиям последнего профиля в массиве. Массив должен содержать не менее двух элементов, иначе при вызове метода filter для растров будет выброшено исключение 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, а эта операция была создана с помощью конструктора, принимающего только аргумент RenderingHints, поскольку операция в этом случае не определена однозначно.

filter

public final WritableRaster filter(Raster src, WritableRaster dest)

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

Определено в:: filter в интерфейсе RasterOp
Параметры:: src — исходный Raster для преобразования; dest — целевой WritableRaster или null
Возвращает:: dest с преобразованным цветом из src или новый преобразованный WritableRaster, если dest равно null
Исключения:: IllegalArgumentException — если число полос источника или назначения неверно, цветовые пространства источника или назначения не определены либо эта операция была создана с помощью одного из конструкторов, предназначенных только для работы с BufferedImage.

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)

Создает нулевой растр назначения правильного размера и с правильным числом полос на основе заданного источника.

Определено в:: createCompatibleDestRaster в интерфейсе RasterOp
Параметры:: src — указанный 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.