Класс ColorConvertOp
- Все реализуемые интерфейсы:
BufferedImageOp, RasterOp
public class ColorConvertOp extends Object implements BufferedImageOp, RasterOp
Если источником является BufferedImage с предварительно умноженным альфа-каналом, цветовые компоненты делятся на компонент альфа-канала перед преобразованием цвета. Если изображением назначения является BufferedImage с предварительно умноженным альфа-каналом, цветовые компоненты умножаются на компонент альфа-канала после преобразования. Растры рассматриваются как не имеющие альфа-канала, то есть все полосы являются цветовыми.
Если в конструкторе указан объект RenderingHints, для управления преобразованием цвета могут использоваться подсказка цветопередачи и подсказка дизеринга.
Обратите внимание, что источник и назначение могут быть одним и тем же объектом.
- См. также:
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
ColorConvertOp |
Создает новый ColorConvertOp на основе двух объектов ColorSpace. |
ColorConvertOp |
Создает новый ColorConvertOp на основе объекта ColorSpace. |
ColorConvertOp |
Создает новый ColorConvertOp на основе массива ICC_Profile. |
ColorConvertOp |
Создает новый ColorConvertOp, который преобразует исходное цветовое пространство в цветовое пространство назначения. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
BufferedImage |
createCompatibleDestImage |
Создает заполненное нулями изображение назначения правильного размера и с правильным количеством полос на основе данного источника. |
WritableRaster |
createCompatibleDestRaster |
Создает заполненный нулями Raster назначения правильного размера и с правильным количеством полос на основе данного источника. |
final BufferedImage |
filter |
Выполняет преобразование цвета исходного BufferedImage. |
final WritableRaster |
filter |
Выполняет преобразование цвета данных изображения в исходном Raster. |
final Rectangle2D |
getBounds2D |
Возвращает ограничивающий прямоугольник назначения на основе данного источника. |
final Rectangle2D |
getBounds2D |
Возвращает ограничивающий прямоугольник назначения на основе данного источника. |
final ICC_Profile[] |
getICC_Profiles() |
Возвращает массив ICC_Profile, использованный для создания этого 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— задает цветовое пространство назначения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)
Для 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.
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— если количество полос источника или назначения неверно, цветовые пространства источника или назначения не определены либо этот оператор был создан с помощью одного из конструкторов, применимых только к операциям над 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)
- Определено в:
-
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
© 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