Spec-Zone.ru › OpenJDK 25

Класс ColorConvertOp

java.lang.Object
java.awt.image.ColorConvertOp
Все реализуемые интерфейсы:
BufferedImageOp, RasterOp
public class ColorConvertOp extends Object implements BufferedImageOp, RasterOp
Этот класс выполняет попиксельное преобразование цвета данных исходного изображения. Результирующие значения цвета масштабируются в соответствии с точностью изображения назначения. Преобразование цвета можно задать с помощью массива объектов ColorSpace или массива объектов ICC_Profile.

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

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

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

См. также:
  • RenderingHints.KEY_COLOR_RENDERING
  • RenderingHints.KEY_DITHERING

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

Конструктор Описание
ColorConvertOp(ColorSpace srcCspace, ColorSpace dstCspace, RenderingHints hints)
Создает новый ColorConvertOp на основе двух объектов ColorSpace.
ColorConvertOp(ColorSpace cspace, RenderingHints hints)
Создает новый ColorConvertOp на основе объекта ColorSpace.
ColorConvertOp(ICC_Profile[] profiles, RenderingHints hints)
Создает новый ColorConvertOp на основе массива ICC_Profile.
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_Profile, использованный для создания этого ColorConvertOp.
final Point2D getPoint2D(Point2D srcPt, Point2D dstPt)
Возвращает положение точки назначения, заданное точкой в источнике.
final RenderingHints getRenderingHints()
Возвращает подсказки рендеринга, используемые этой операцией.

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

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

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

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 определяют операцию, выполняемую над растрами. При этом количество полос в исходном Raster должно совпадать с количеством компонентов в srcCspace, а количество полос в Raster назначения должно совпадать с количеством компонентов в dstCspace. Для BufferedImage два объекта ColorSpace задают промежуточные пространства, через которые преобразуется источник перед преобразованием в пространство назначения.
Параметры:
srcCspace — исходное цветовое пространство ColorSpace
dstCspace — цветовое пространство назначения ColorSpace
hints — объект RenderingHints, используемый для управления преобразованием цвета, или null
Исключения:
NullPointerException — если srcCspace или dstCspace равен null

ColorConvertOp

public ColorConvertOp(ICC_Profile[] profiles, RenderingHints hints)
Создает новый ColorConvertOp на основе массива ICC_Profile. Аргумент RenderingHints может иметь значение null. Последовательность профилей может включать профили, представляющие цветовые пространства, профили, представляющие эффекты, и т. д. Если вся последовательность не задает корректно определенное преобразование цвета, выбрасывается исключение.

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

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

Параметры:
profiles — массив объектов ICC_Profile
hints — объект RenderingHints, используемый для управления преобразованием цвета, или null
Исключения:
IllegalArgumentException — если последовательность профилей не задает корректно определенное преобразование цвета
NullPointerException — если profiles равен null

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

getICC_Profiles

public final ICC_Profile[] getICC_Profiles()
Возвращает массив ICC_Profile, использованный для создания этого ColorConvertOp. Возвращает null, если ColorConvertOp был создан не из такого массива.
Возвращает:
массив объектов ICC_Profile этого ColorConvertOp или null, если этот ColorConvertOp был создан не с помощью массива объектов ICC_Profile.

filter

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

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в документации Java SE, содержащей более подробные описания для разработчиков, обзоры концепций, определения терминов, обходные решения и рабочие примеры кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторские права © 1993, 2025, Oracle и/или ее аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 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://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/java/awt/image/ColorConvertOp.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API