Spec-Zone.ru › OpenJDK 17

Класс 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. Этот объект можно использовать только с BufferedImages и он будет преобразовывать напрямую из цветового пространства исходного изображения в цветовое пространство назначения. Аргумент назначения метода filter не может быть null.
Параметры:
hints - объект RenderingHints, используемый для управления преобразованием цвета, или null

ColorConvertOp

public ColorConvertOp(ColorSpace cspace, RenderingHints hints)
Создаёт новый ColorConvertOp из объекта ColorSpace. Аргумент RenderingHints может быть null. Этот объект можно использовать только с BufferedImages и он наиболее полезен, когда метод filter вызывается с аргументом назначения null. В этом случае ColorSpace определяет цветовое пространство назначения, созданное методом filter. В противном случае, ColorSpace определяет промежуточное пространство, в которое преобразуется источник, прежде чем быть преобразованным в пространство назначения.
Параметры:
cspace - определяет целевое цветовое пространство или промежуточное цветовое пространство
hints - объект RenderingHints, используемый для управления преобразованием цвета, или null
Исключения:
NullPointerException - если cspace равно null

ColorConvertOp

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

getBounds2D

public final Rectangle2D getBounds2D(BufferedImage src)
Возвращает ограничивающую рамку назначения, учитывая этот источник. Обратите внимание, что она будет такой же, как и ограничивающая рамка источника.
Определено в:
getBounds2D в интерфейсе BufferedImageOp
Параметры:
src - исходное изображение
Возвращает:
объект Rectangle2D, представляющий ограничивающую рамку назначения, учитывая указанное изображение

getBounds2D

public final Rectangle2D getBounds2D(Raster src)
Возвращает ограничивающую рамку назначения, учитывая этот источник. Обратите внимание, что она будет такой же, как и ограничивающая рамка источника.
Определено в:
getBounds2D в интерфейсе RasterOp
Параметры:
src - исходное изображение
Возвращает:
объект Rectangle2D, представляющий ограничивающую рамку назначения, учитывая указанное изображение

createCompatibleDestImage

public BufferedImage createCompatibleDestImage(BufferedImage src, ColorModel destCM)
Создаёт нулевое целевое изображение с правильным размером и количеством каналов, учитывая этот источник.
Определено в:
createCompatibleDestImage в интерфейсе BufferedImageOp
Параметры:
src - Исходное изображение для операции фильтрации.
destCM - ColorModel назначения. Если null, будет использоваться подходящий ColorModel.
Возвращает:
объект BufferedImage с правильным размером и количеством каналов, полученным из указанного изображения.
Исключения:
IllegalArgumentException - если destCM равно null и этот ColorConvertOp был создан без ICC_Profile или ColorSpace определённых для назначения

createCompatibleDestRaster

public WritableRaster createCompatibleDestRaster(Raster src)
Создаёт нулевой целевой Raster с правильным размером и количеством каналов, учитывая этот источник.
Определено в:
createCompatibleDestRaster в интерфейсе RasterOp
Параметры:
src - Указанное изображение
Возвращает:
объект WritableRaster с правильным размером и количеством каналов, полученным из указанного изображения
Исключения:
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, 2021, 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/17/docs/api/java.desktop/java/awt/image/ColorConvertOp.html

Spec-Zone.ru

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