Класс 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

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

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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/java/awt/image/LookupOp.html