Класс LookupOp

java.lang.Object

java.awt.image.LookupOp

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

public class LookupOp extends Object implements BufferedImageOp, RasterOp

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

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

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

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

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

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

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

См. также:

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

Конструктор	Описание
`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)`	Возвращает ограничивающий прямоугольник отфильтрованного целевого Raster.
`final Point2D`	`getPoint2D(Point2D srcPt, Point2D dstPt)`	Возвращает координаты целевой точки по заданной точке источника.
`final RenderingHints`	`getRenderingHints()`	Возвращает подсказки визуализации для этой операции.
`final LookupTable`	`getTable()`	Возвращает `LookupTable`.

Методы, объявленные в классе Object

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Проверяет, является ли другой объект равным этому объекту.
`protected void`	`finalize()`	Устарело, подлежит удалению: этот элемент API будет удален в будущей версии. Финализация объявлена устаревшей и подлежит удалению в одном из следующих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Приостанавливает текущий поток до его пробуждения, обычно вследствие вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Приостанавливает текущий поток до его пробуждения, обычно вследствие вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Приостанавливает текущий поток до его пробуждения, обычно вследствие вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

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

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