Класс AffineTransformOp

java.lang.Object

java.awt.image.AffineTransformOp

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

public class AffineTransformOp extends Object implements BufferedImageOp, RasterOp

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

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

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

Исходное и целевое изображения должны быть различными.
Для объектов Raster, число каналов в исходном изображении должно быть равно числу каналов в целевом изображении.

См. также:

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

Модификатор и тип	Поле	Описание
`static final int`	`TYPE_BICUBIC`	Тип бикубической интерполяции.
`static final int`	`TYPE_BILINEAR`	Тип билинейной интерполяции.
`static final 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` с нулевыми значениями, соответствующего размера и числа каналов.
`final BufferedImage`	`filter(BufferedImage src, BufferedImage dst)`	Преобразует исходное `BufferedImage` и сохраняет результаты в целевом `BufferedImage`.
`final WritableRaster`	`filter(Raster src, WritableRaster dst)`	Преобразует исходное `Raster` и сохраняет результаты в целевом `Raster`.
`final Rectangle2D`	`getBounds2D(BufferedImage src)`	Возвращает область границ преобразованного целевого изображения.
`final Rectangle2D`	`getBounds2D(Raster src)`	Возвращает область границ преобразованного целевого изображения.
`final int`	`getInterpolationType()`	Возвращает тип интерполяции, используемый этим объектом.
`final Point2D`	`getPoint2D(Point2D srcPt, Point2D dstPt)`	Возвращает расположение соответствующей точки целевого изображения по заданной точке в исходном изображении.
`final RenderingHints`	`getRenderingHints()`	Возвращает параметры отрисовки, используемые этим преобразованием.
`final 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 - если преобразование необратимо.

См. также:

AffineTransformOp

public AffineTransformOp(AffineTransform xform, int interpolationType)

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

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

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

getInterpolationType

public final int getInterpolationType()

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

Возвращает:

тип интерполяции.

См. также:

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

getBounds2D

public final Rectangle2D getBounds2D(Raster src)

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

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

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 - Point2D, представляющий точку источника.; dstPt - Point2D, в котором будет храниться результат.
Возвращает:: Point2D в назначении, соответствующий указанной точке в источнике.

getTransform

public final AffineTransform getTransform()

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

Возвращает:: Соответствующее AffineTransform этой операции.

getRenderingHints

public final RenderingHints getRenderingHints()

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

Определено в:: getRenderingHints в интерфейсе BufferedImageOp
Определено в:: getRenderingHints в интерфейсе RasterOp
Возвращает:: Объект RenderingHints , связанный с этой операцией.

© 1993, 2023, 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/21/docs/api/java.desktop/java/awt/image/AffineTransformOp.html