Spec-Zone.ru › OpenJDK 21

Класс 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 для управления преобразованием цвета.

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

См. также:
  • 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_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()
Возвращает настройки рендеринга, используемые этим оператором.

Методы, объявленные в классе 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
Возвращает:
объект WritableRaster с правильным размером и количеством каналов из указанного src
Исключения:
IllegalArgumentException - если этот ColorConvertOp был создан без достаточной информации для определения цветовых пространств dst и src

getPoint2D

public final Point2D getPoint2D(Point2D srcPt, Point2D dstPt)
Возвращает расположение целевой точки, заданной точкой в источнике. Если dstPt не равно null, оно будет использовано для хранения возвращаемого значения. Обратите внимание, что для этого класса целевая точка будет такой же, как и исходная точка.
Specified by:
getPoint2D в интерфейсе BufferedImageOp
Specified by:
getPoint2D в интерфейсе RasterOp
Parameters:
srcPt - указанный исходный Point2D
dstPt - целевая Point2D
Returns:
dstPt после установки его расположения таким же, как у srcPt

getRenderingHints

public final RenderingHints getRenderingHints()
Возвращает используемые этим методом параметры отрисовки.
Specified by:
getRenderingHints в интерфейсе BufferedImageOp
Specified by:
getRenderingHints в интерфейсе RasterOp
Returns:
объект RenderingHints этого ColorConvertOp

© 1993, 2023, 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/21/docs/api/java.desktop/java/awt/image/ColorConvertOp.html

Spec-Zone.ru

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