Класс ColorConvertOp
- Все реализованные интерфейсы:
-
BufferedImageOp,RasterOp
public class ColorConvertOp extends Object implements BufferedImageOp, RasterOp
Если исходное изображение — BufferedImage с предварительно умноженным альфа-каналом, компоненты цвета делятся на компонент альфа-канала перед преобразованием цвета. Если изображение назначения — BufferedImage с предварительно умноженным альфа-каналом, компоненты цвета умножаются на компонент альфа-канала после преобразования. Растровые изображения рассматриваются как не имеющие альфа-канала, т. е. все полосы являются полосами цвета.
Если в конструкторе задан объект RenderingHints, то может быть использовано свойство рендеринга цвета и свойство дithering для управления преобразованием цвета.
Обратите внимание, что Исходное и Предназначенное изображения могут быть одним и тем же объектом.
- См. также:
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
ColorConvertOp |
Создаёт новый ColorConvertOp из двух объектов ColorSpace. |
ColorConvertOp |
Создаёт новый ColorConvertOp из объекта ColorSpace. |
ColorConvertOp |
Создаёт новый ColorConvertOp из массива объектов ICC_Profiles. |
ColorConvertOp |
Создаёт новый ColorConvertOp, который будет преобразовывать из исходного пространства цветов в пространство цветов назначения. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
BufferedImage |
createCompatibleDestImage |
Создаёт нулевое изображение назначения с правильным размером и количеством полос, исходя из этого источника. |
WritableRaster |
createCompatibleDestRaster |
Создаёт нулевой растр назначения с правильным размером и количеством полос, исходя из этого источника. |
final BufferedImage |
filter |
Преобразует цвет исходного BufferedImage. |
final WritableRaster |
filter |
Преобразует данные изображения в исходном растре. |
final Rectangle2D |
getBounds2D |
Возвращает область границ назначения, исходя из этого источника. |
final Rectangle2D |
getBounds2D |
Возвращает область границ назначения, исходя из этого источника. |
final ICC_Profile[] |
getICC_Profiles() |
Возвращает массив ICC_Profiles, используемый для создания этого ColorConvertOp. |
final Point2D |
getPoint2D |
Возвращает местоположение точки назначения, заданной точкой в источнике. |
final RenderingHints |
getRenderingHints() |
Возвращает настройки рендеринга, используемые этим оператором. |
Подробное описание конструкторов
ColorConvertOp
public ColorConvertOp(RenderingHints hints)
- Параметры:
-
hints- объектRenderingHints, используемый для управления преобразованием цвета, илиnull
ColorConvertOp
public ColorConvertOp(ColorSpace cspace, RenderingHints hints)
filter вызывается с аргументом destination, равным null. В этом случае ColorSpace определяет целевое цветовое пространство для изображения назначения, созданного методом filter. В противном случае ColorSpace определяет промежуточное пространство, в которое преобразуется исходное изображение перед преобразованием в целевое пространство.- Параметры:
-
cspace- определяет целевоеColorSpaceили промежуточноеColorSpace -
hints- объектRenderingHints, используемый для управления преобразованием цвета, илиnull - Исключения:
-
NullPointerException- если cspace равно null
ColorConvertOp
public ColorConvertOp(ColorSpace srcCspace, ColorSpace dstCspace, RenderingHints hints)
- Параметры:
-
srcCspace- исходноеColorSpace -
dstCspace- целевоеColorSpace -
hints- объектRenderingHints, используемый для управления преобразованием цвета, илиnull - Исключения:
-
NullPointerException- если srcCspace или dstCspace равно null
ColorConvertOp
public ColorConvertOp(ICC_Profile[] profiles, RenderingHints hints)
Для 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_ProfileданногоColorConvertOp, илиnullесли этотColorConvertOpне был создан с массивом объектовICC_Profile.
filter
public final BufferedImage filter(BufferedImage src, BufferedImage dest)
- Унаследованно от:
-
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)
- Унаследованно от:
-
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)
- Унаследованно от:
-
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