Класс LookupOp

java.lang.Object

java.awt.image.LookupOp

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

public class LookupOp extends Object implements BufferedImageOp, RasterOp

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

Для растровых изображений поиск осуществляется по каналам. Количество массивов поиска может быть одним, в таком случае один и тот же массив применяется ко всем каналам, или оно должно быть равно числу каналов исходного растрового изображения.

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

Источники 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(Raster 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.
Возвращает:: целевое BufferedImage изображения.

createCompatibleDestRaster

public WritableRaster createCompatibleDestRaster(Raster src)

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

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

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, 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/LookupOp.html