Класс LookupOp

public class LookupOp
extends Object
implements BufferedImageOp, RasterOp

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

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

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

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

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

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

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

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

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. Если модель цвета в изображении-источнике отличается от модели цвета в изображении-назначении, пиксели будут преобразованы в изображении назначения. Если изображение назначения пустое, будет создано 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 пустое, будет создан новый Raster . Может быть выброшено исключение IllegalArgumentException , если у изображения-источника и назначения 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 пустое, будет использована соответствующая модель цвета.

Определено в:

createCompatibleDestImage в интерфейсе BufferedImageOp

Параметры:

src - Изображение-источник для операции фильтрации.

destCM - Модель цвета назначения, которая может быть null.

Возвращает:

отфильтрованное изображение назначения.

createCompatibleDestRaster

public WritableRaster createCompatibleDestRaster(Raster src)

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

Определено в:

createCompatibleDestRaster в интерфейсе RasterOp

Параметры:

src - изображение-источник для преобразования

Возвращает:

пустое растровое изображение назначения.

getPoint2D

public final Point2D getPoint2D(Point2D srcPt,
                                Point2D dstPt)

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

Определено в:

getPoint2D в интерфейсе BufferedImageOp

Определено в:

getPoint2D в интерфейсе RasterOp

Параметры:

srcPt - Point2D представляющий точку в изображении-источнике

dstPt - Point2D представляющий координаты точки в изображении-назначении

Возвращает:

координаты точки в изображении-назначении, соответствующие заданной точке в изображении-источнике.

getRenderingHints

public final RenderingHints getRenderingHints()

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

Определено в:

getRenderingHints в интерфейсе BufferedImageOp

Определено в:

getRenderingHints в интерфейсе RasterOp

Возвращает:

объект параметров рендеринга, связанный с этой операцией.