Класс AffineTransformOp

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

Этот класс использует аффинное преобразование для выполнения линейного отображения из 2D-координат на исходном изображении или Raster в 2D-координаты на целевом изображении или Raster. Тип интерполяции задается через конструктор, либо с помощью объекта RenderingHints, либо с помощью одного из целочисленных типов интерполяции, определенных в этом классе.

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

Обратите внимание, что должны быть соблюдены следующие ограничения:

  • Исходное и целевое изображения должны быть разными.
  • Для объектов Raster количество каналов в исходном изображении должно быть равно количеству каналов в целевом изображении.
См. также:
AffineTransform, BufferedImageFilter, RenderingHints.KEY_INTERPOLATION, RenderingHints.KEY_RENDERING, RenderingHints.KEY_COLOR_RENDERING, RenderingHints.KEY_DITHERING

Краткое описание полей

Модификатор и тип Поле Описание
static int TYPE_BICUBIC

Тип бикубической интерполяции.
static int TYPE_BILINEAR

Тип билинейной интерполяции.
static int TYPE_NEAREST_NEIGHBOR

Тип интерполяции ближайшего соседа.

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

Конструктор Описание
AffineTransformOp​(AffineTransform xform, int interpolationType)

Создает объект AffineTransformOp на основе аффинного преобразования и типа интерполяции.
AffineTransformOp​(AffineTransform xform, RenderingHints hints)

Создает объект AffineTransformOp на основе аффинного преобразования.

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

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

Создает целевое изображение со значением нуля, с правильным размером и количеством каналов.
WritableRaster createCompatibleDestRaster​(Raster src)

Создает целевой Raster со значением нуля, с правильным размером и количеством каналов.
BufferedImage filter​(BufferedImage src, BufferedImage dst)

Преобразует исходное BufferedImage и сохраняет результаты в целевом BufferedImage.
WritableRaster filter​(Raster src, WritableRaster dst)

Преобразует исходное Raster и сохраняет результаты в целевом Raster.
Rectangle2D getBounds2D​(BufferedImage src)

Возвращает ограничивающую рамку преобразованного целевого изображения.
Rectangle2D getBounds2D​(Raster src)

Возвращает ограничивающую рамку преобразованного целевого изображения.
int getInterpolationType()

Возвращает тип интерполяции, используемый этим объектом.
Point2D getPoint2D​(Point2D srcPt, Point2D dstPt)

Возвращает расположение соответствующей точки в целевом изображении, заданной точкой в исходном изображении.
RenderingHints getRenderingHints()

Возвращает настройки рендеринга, используемые этой операцией преобразования.
AffineTransform getTransform()

Возвращает аффинное преобразование, используемое этой операцией преобразования.

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

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

Поля

TYPE_NEAREST_NEIGHBOR

@Native
public static final int TYPE_NEAREST_NEIGHBOR

Тип интерполяции ближайшего соседа.

См. также:
Значения константных полей

TYPE_BILINEAR

@Native
public static final int TYPE_BILINEAR

Тип интерполяции билинейной.

См. также:
Значения константных полей

TYPE_BICUBIC

@Native
public static final int TYPE_BICUBIC

Тип интерполяции бикубической.

См. также:
Значения константных полей

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

AffineTransformOp

public AffineTransformOp(AffineTransform xform,
                         RenderingHints hints)

Конструирует AffineTransformOp с заданным аффинным преобразованием. Тип интерполяции определяется из объекта RenderingHints. Если указан намек на интерполяцию, он будет использован. В противном случае, если задан намек на качество рендеринга, тип интерполяции определяется по его значению. Если намеки не заданы (hints равно null), тип интерполяции — TYPE_NEAREST_NEIGHBOR.

Параметры:
xform - AffineTransform для операции.
hints - Объект RenderingHints, используемый для указания типа интерполяции для операции.
Исключения:
ImagingOpException - если преобразование необратимо.
См. также:
RenderingHints.KEY_INTERPOLATION, RenderingHints.KEY_RENDERING

AffineTransformOp

public AffineTransformOp(AffineTransform xform,
                         int interpolationType)

Конструирует AffineTransformOp с заданным аффиным преобразованием и типом интерполяции.

Параметры:
xform - AffineTransform для операции.
interpolationType - Одно из целочисленных константных значений типа интерполяции, определённых в этом классе: TYPE_NEAREST_NEIGHBOR, TYPE_BILINEAR, TYPE_BICUBIC.
Исключения:
ImagingOpException - если преобразование необратимо.

Методы

getInterpolationType

public final int getInterpolationType()

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

Возвращает:
тип интерполяции.
См. также:
TYPE_NEAREST_NEIGHBOR, TYPE_BILINEAR, TYPE_BICUBIC

filter

public final BufferedImage filter(BufferedImage src,
                                  BufferedImage dst)

Преобразует исходное изображение BufferedImage и сохраняет результаты в целевое изображение BufferedImage. Если цветовые модели двух изображений не совпадают, выполняется преобразование цвета в целевую цветовую модель. Если целевое изображение равно null, создается новое изображение BufferedImage с размерами исходного изображения ColorModel.

Координаты прямоугольника, возвращаемого методом getBounds2D(BufferedImage), необязательно совпадают с координатами прямоугольника BufferedImage , возвращаемого этим методом. Если координаты верхнего левого угла прямоугольника отрицательные, эта часть прямоугольника не отображается. Если координаты положительные, отфильтрованное изображение отображается в указанном месте в целевом изображении BufferedImage.

Бросается исключение IllegalArgumentException , если исходное и целевое изображения совпадают.

Определено в:
filter в интерфейсе BufferedImageOp
Параметры:
src - Преобразуемое изображение BufferedImage.
dst - Целевое изображение BufferedImage, в которое сохраняются результаты преобразования.
Возвращает:
Отфильтрованное изображение BufferedImage.
Исключение:
IllegalArgumentException - если исходное изображение src и целевое изображение dst одинаковы
ImagingOpException - если изображение не может быть преобразовано из-за ошибки обработки данных, которая может быть вызвана неверным форматом изображения, форматом плитки или операцией обработки изображений, или любой другой неподдерживаемой операцией.

filter

public final WritableRaster filter(Raster src,
                                   WritableRaster dst)

Преобразует исходное растровое изображение Raster и сохраняет результаты в целевом растровом изображении Raster. Эта операция выполняется по полосам.

Если целевое растровое изображение Raster равно null, создаётся новое растровое изображение Raster. Может быть брошено исключение IllegalArgumentException , если исходное и целевое изображения совпадают или если количество полос в исходном и целевом изображениях не совпадает.

Координаты прямоугольника, возвращаемого getBounds2D(Raster), необязательно совпадают с координатами прямоугольника WritableRaster , возвращаемого этим методом. Если координаты верхнего левого угла прямоугольника отрицательные, эта часть прямоугольника не отображается. Если координаты положительные, отфильтрованное изображение отображается в указанном месте в целевом растровом изображении Raster.

Определено в:
filter в интерфейсе RasterOp
Параметры:
src - Преобразуемое растровое изображение Raster.
dst - Целевое растровое изображение Raster, в которое сохраняются результаты преобразования.
Возвращает:
Преобразованное растровое изображение Raster.
Исключение:
ImagingOpException - если растровое изображение не может быть преобразовано из-за ошибки обработки данных, которая может быть вызвана неверным форматом изображения, форматом плитки или операцией обработки изображений, или любой другой неподдерживаемой операцией.

getBounds2D

public final Rectangle2D getBounds2D(BufferedImage src)

Возвращает ограничивающую рамку преобразованного целевого изображения. Возвращаемый прямоугольник — это фактическая ограничивающая рамка преобразованных точек. Координаты верхнего левого угла возвращаемого прямоугольника могут не быть (0, 0).

Определено в:
getBounds2D в интерфейсе BufferedImageOp
Параметры:
src - Преобразуемое изображение BufferedImage.
Возвращает:
Прямоугольник, представляющий ограничивающую рамку целевого изображения.

getBounds2D

public final Rectangle2D getBounds2D(Raster src)

Возвращает ограничивающую рамку преобразованного целевого изображения. Возвращаемый прямоугольник — это фактическая ограничивающая рамка преобразованных точек. Координаты верхнего левого угла возвращаемого прямоугольника могут не быть (0, 0).

Определено в:
getBounds2D в интерфейсе RasterOp
Параметры:
src - Преобразуемое растровое изображение Raster.
Возвращает:
Прямоугольник, представляющий ограничивающую рамку целевого изображения.

createCompatibleDestImage

public BufferedImage createCompatibleDestImage(BufferedImage src,
                                               ColorModel destCM)

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

Если destCM равно null, используется соответствующая цветовая модель ColorModel; эта цветовая модель ColorModel может иметь альфа-канал, даже если исходное изображение ColorModel непрозрачное.

Указано в:
createCompatibleDestImage в интерфейсе BufferedImageOp
Параметры:
src - Преобразуемое BufferedImage.
destCM - ColorModel назначения. Если null, используется соответствующее ColorModel.
Возвращает:
Изображение назначения с нулевыми значениями.

createCompatibleDestRaster

public WritableRaster createCompatibleDestRaster(Raster src)

Создаёт изображение назначения Raster с правильным размером и количеством каналов. Может быть выброшено исключение RasterFormatException, если преобразованная ширина или высота равны 0.

Указано в:
createCompatibleDestRaster в интерфейсе RasterOp
Параметры:
src - Преобразуемое Raster.
Возвращает:
Изображение назначения Raster с нулевыми значениями.

getPoint2D

public final Point2D getPoint2D(Point2D srcPt,
                                Point2D dstPt)

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

Указано в:
getPoint2D в интерфейсе BufferedImageOp
Указано в:
getPoint2D в интерфейсе RasterOp
Параметры:
srcPt - Точка в источнике.
dstPt - Точка в которой хранить результат.
Возвращает:
Точка в Point2D назначения, соответствующая указанной точке в источнике.

getTransform

public final AffineTransform getTransform()

Возвращает аффинное преобразование, используемое этой операцией преобразования.

Возвращает:
Преобразование, связанное с этой операцией.

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/AffineTransformOp.html

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