Класс LookupOp

java.lang.Object

java.awt.image.LookupOp

Все реализованные интерфейсы:: BufferedImageOp, RasterOp

public class LookupOp extends Object implements BufferedImageOp, RasterOp

Этот класс реализует операцию поиска соответствий из источника в назначение. Объект LookupTable может содержать один массив или несколько массивов, в зависимости от ограничений ниже.

Для растров операция поиска соответствий выполняется по каналам. Количество массивов поиска может быть одним, в этом случае один и тот же массив применяется ко всем каналам, или оно должно быть равно количеству каналов растра-источника.

Для изображений BufferedImages операция поиска соответствий выполняется по цветовым и альфа-компонентам. Количество массивов поиска может быть одним, в этом случае один и тот же массив применяется ко всем цветовым (но не альфа) компонентам. В противном случае количество массивов поиска может быть равно количеству цветовых компонентов источника, в этом случае поиск по альфа-компоненту (если он присутствует) не выполняется. Если ни одно из этих условий не выполняется, количество массивов поиска должно быть равно количеству цветовых компонентов источника плюс альфа-компоненты, в этом случае поиск выполняется для всех цветовых и альфа-компонентов. Это позволяет выполнять нелинейное масштабирование многоканальных изображений BufferedImages.

Источники BufferedImage с предварительно умноженными альфа-данными обрабатываются таким же образом, как и изображения без предварительного умножения для целей поиска соответствий. То есть поиск соответствий выполняется по каждому каналу на исходных данных изображения BufferedImage без учета того, предварительно ли умножены данные. Если для назначения требуется преобразование цвета в ColorModel, состояние предварительного умножения как источника, так и назначения будет учтено на этом шаге.

Изображения с IndexColorModel использовать нельзя.

Если в конструкторе задан объект RenderingHints, то при необходимости преобразования цвета могут использоваться настройки цветового рендеринга и параметр дithering.

Этот класс позволяет использовать источник, совпадающий с назначением.

См. также:

Краткое описание конструкторов

Конструктор	Описание
`LookupOp(LookupTable lookup, RenderingHints hints)`	Создаёт объект `LookupOp`, используя таблицу поиска и объект `RenderingHints`, который может быть `null`.

Краткое описание методов

Модификатор и тип	Метод	Описание
`BufferedImage`	`createCompatibleDestImage(BufferedImage src, ColorModel destCM)`	Создаёт изображение назначения с нулевыми значениями, правильного размера и количества каналов.
`WritableRaster`	`createCompatibleDestRaster(Raster src)`	Создаёт изображение назначения `Raster` с нулевыми значениями и правильным размером и количеством каналов на основе исходного изображения.
`final BufferedImage`	`filter(BufferedImage src, BufferedImage dst)`	Выполняет операцию поиска соответствий на растре `BufferedImage`.
`final WritableRaster`	`filter(Raster src, WritableRaster dst)`	Выполняет операцию поиска соответствий на изображении `Raster`.
`final Rectangle2D`	`getBounds2D(BufferedImage src)`	Возвращает область изображения назначения, после фильтрации.
`final Rectangle2D`	`getBounds2D(Raster src)`	Возвращает область растра назначения, после фильтрации.
`final Point2D`	`getPoint2D(Point2D srcPt, Point2D dstPt)`	Возвращает координату точки назначения, соответствующую точке в источнике.
`final RenderingHints`	`getRenderingHints()`	Возвращает параметры рендеринга для этой операции.
`final LookupTable`	`getTable()`	Возвращает `LookupTable`.

Методы, унаследованные от класса java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробное описание конструкторов

LookupOp

public LookupOp(LookupTable lookup, RenderingHints hints)

Создаёт объект LookupOp с заданной таблицей поиска и объектом RenderingHints, который может быть null.

Параметры:: lookup - указанная LookupTable; hints - указанные RenderingHints или null

Подробное описание методов

getTable

public final LookupTable getTable()

Возвращает LookupTable.

Возвращает:: таблицу LookupTable данного LookupOp.

filter

public final BufferedImage filter(BufferedImage src, BufferedImage dst)

Выполняет операцию поиска по BufferedImage. Если цветовой профиль в исходном изображении отличается от профиля в целевом изображении, пиксели будут преобразованы в целевое изображение. Если целевое изображение null, будет создано BufferedImage с соответствующим ColorModel. Может быть выброшено исключение IllegalArgumentException, если количество массивов в LookupTable не соответствует ограничениям, указанным в комментарии к классу выше, или если исходное изображение имеет IndexColorModel.

Задано в:: filter в интерфейсе BufferedImageOp
Параметры:: src - изображение BufferedImage для фильтрации; dst - изображение BufferedImage, в котором должны храниться результаты операции фильтрации
Возвращает:: отфильтрованное изображение BufferedImage.
Исключение:: IllegalArgumentException - если количество массивов в LookupTable не соответствует ограничениям, описанным в комментариях к классу, или если исходное изображение имеет IndexColorModel.

filter

public final WritableRaster filter(Raster src, WritableRaster dst)

Выполняет операцию поиска по Raster. Если целевой Raster является null, будет создан новый Raster. Может быть выброшено исключение IllegalArgumentException, если у исходного Raster и целевого Raster разное количество каналов или если количество массивов в LookupTable не соответствует ограничениям, указанным в комментарии к классу.

Задано в:: filter в интерфейсе RasterOp
Параметры:: src - исходный Raster для фильтрации; dst - целевой WritableRaster для отфильтрованного src
Возвращает:: отфильтрованный WritableRaster.
Исключение:: IllegalArgumentException - если у исходного и целевого растров разное количество каналов или если количество массивов в LookupTable не соответствует ограничениям, описанным в комментариях к классу.

getBounds2D

public final Rectangle2D getBounds2D(BufferedImage src)

Возвращает прямоугольник, определяющий границы отфильтрованного целевого изображения. Поскольку это не геометрическая операция, прямоугольник не изменяется.

Задано в:: getBounds2D в интерфейсе BufferedImageOp
Параметры:: src - изображение BufferedImage для фильтрации
Возвращает:: прямоугольник, определяющий границы отфильтрованного изображения.

getBounds2D

public final Rectangle2D getBounds2D(Raster src)

Возвращает прямоугольник, определяющий границы отфильтрованного целевого растра. Поскольку это не геометрическая операция, прямоугольник не изменяется.

Задано в:: getBounds2D в интерфейсе RasterOp
Параметры:: src - Raster для фильтрации
Возвращает:: прямоугольник, определяющий границы отфильтрованного целевого растра.

createCompatibleDestImage

public BufferedImage createCompatibleDestImage(BufferedImage src, ColorModel destCM)

Создаёт нулевое целевое изображение с правильным размером и количеством каналов. Если destCM является null, будет использован соответствующий ColorModel.

Задано в:: createCompatibleDestImage в интерфейсе BufferedImageOp
Параметры:: src - Исходное изображение для операции фильтрации.; destCM - ColorModel целевого изображения, которое может быть null.
Возвращает:: отфильтрованное целевое изображение.

createCompatibleDestRaster

public WritableRaster createCompatibleDestRaster(Raster src)

Создаёт нулевой целевой растр с правильным размером и количеством каналов, заданных исходным изображением.

Задано в:: createCompatibleDestRaster в интерфейсе RasterOp
Параметры:: src - растр, подлежащий преобразованию
Возвращает:: нулевой целевой растр.

getPoint2D

public final Point2D getPoint2D(Point2D srcPt, Point2D dstPt)

Возвращает положение целевой точки, заданной точкой в исходном изображении. Если dstPt не null, он будет использован для хранения возвращаемого значения. Поскольку это не геометрическая операция, srcPt будет равно dstPt.

Задано в:: getPoint2D в интерфейсе BufferedImageOp
Задано в:: getPoint2D в интерфейсе RasterOp
Параметры:: srcPt - Point2D, представляющий точку в исходном изображении; dstPt - Point2D, представляющий местоположение в целевом изображении
Возвращает:: Point2D в целевом изображении, соответствующий заданной точке в исходном изображении.

getRenderingHints

public final RenderingHints getRenderingHints()

Возвращает параметры рендеринга для данной операции.

Задано в:: getRenderingHints в интерфейсе BufferedImageOp
Задано в:: getRenderingHints в интерфейсе RasterOp
Возвращает:: объект RenderingHints, связанный с данной операцией.

© 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/awt/image/LookupOp.html