Класс 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 вызывается с аргументом назначения null. В этом случае ColorSpace определяет цветовое пространство назначения, созданное методом filter. В противном случае, ColorSpace определяет промежуточное пространство, в которое преобразуется источник, прежде чем быть преобразованным в пространство назначения.- Параметры:
-
cspace- определяет целевое цветовое пространство или промежуточное цветовое пространство -
hints- объектRenderingHints, используемый для управления преобразованием цвета, илиnull - Исключения:
-
NullPointerException- если cspace равно null
ColorConvertOp
public ColorConvertOp(ColorSpace srcCspace, ColorSpace dstCspace, RenderingHints hints)
- Параметры:
-
srcCspace- исходное цветовое пространство -
dstCspace- целевое цветовое пространство -
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, и этот объект был создан с конструктором, принимающим только аргумент RenderingHints, так как операция не определена.
filter
public final WritableRaster filter(Raster src, WritableRaster dest)
- Определено в:
-
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)
- Определено в:
-
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