Класс LookupOp

java.lang.Object

java.awt.image.LookupOp

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

public class LookupOp extends Object implements BufferedImageOp, RasterOp

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

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

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

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

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

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

Этот класс позволяет использовать один и тот же объект в качестве источника и назначения.

См. также:

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

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

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

Модификатор и тип	Метод	Описание
`BufferedImage`	`createCompatibleDestImage(BufferedImage src, ColorModel destCM)`	Создаёт изображение назначения с нулевыми значениями, правильным размером и числом каналов.
`WritableRaster`	`createCompatibleDestRaster(Raster src)`	Создаёт изображение назначения (zeroed-destination `Raster`) с нулевыми значениями, правильным размером и числом каналов, исходя из данного источника.
`final BufferedImage`	`filter(BufferedImage src, BufferedImage dst)`	Выполняет операцию поиска (lookup) на растровом изображении `BufferedImage`.
`final WritableRaster`	`filter(Raster src, WritableRaster dst)`	Выполняет операцию поиска (lookup) на изображении `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)

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

Определено в:: getBounds2D в интерфейсе RasterOp
Параметры:: src - Raster для фильтрации
Возвращает:: границы отфильтрованного 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 представляющая координаты в целевом изображении
Возвращает:: координаты точки в целевом изображении, соответствующие заданной точке в исходном изображении.

getRenderingHints

public final RenderingHints getRenderingHints()

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

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

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