Класс LookupOp
- java.lang.Object
-
- java.awt.image.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) | Создаёт объект |
Методы
| Модификатор и тип | Метод | Описание |
|---|---|---|
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() | Возвращает |
Методы, унаследованные от класса 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