Класс LookupOp

Все реализованные интерфейсы:
BufferedImageOp, RasterOp
public class LookupOp
extends Object
implements BufferedImageOp, RasterOp

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

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

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

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

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

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

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

См. также:
LookupTable, RenderingHints.KEY_COLOR_RENDERING, RenderingHints.KEY_DITHERING

Конструкторы

Конструктор Описание
LookupOp​(LookupTable lookup, RenderingHints hints)

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

Методы

Модификатор и тип Метод Описание
BufferedImage createCompatibleDestImage​(BufferedImage src, ColorModel destCM)

Создаёт целевое изображение с нулевыми значениями, соответствующего размера и количества каналов.

WritableRaster createCompatibleDestRaster​(Raster src)

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

BufferedImage filter​(BufferedImage src, BufferedImage dst)

Выполняет операцию поиска по растровому изображению (Raster).

WritableRaster filter​(Raster src, WritableRaster dst)

Выполняет операцию поиска по изображению BufferedImage.

Rectangle2D getBounds2D​(BufferedImage src)

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

Rectangle2D getBounds2D​(Raster src)

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

Point2D getPoint2D​(Point2D srcPt, Point2D dstPt)

Возвращает координаты целевой точки, соответствующие точке в источнике.

RenderingHints getRenderingHints()

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

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 - Raster для преобразования
Возвращает:
целевой растр с нулевыми значениями.

getPoint2D

public final Point2D getPoint2D(Point2D srcPt,
                                Point2D dstPt)

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

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

getRenderingHints

public final RenderingHints getRenderingHints()

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

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

© 1993, 2020, 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/11/docs/api/java.desktop/java/awt/image/LookupOp.html

Spec-Zone .ru
спецификации, руководства, описания, API