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

getBounds2D

public final Rectangle2D getBounds2D(Raster src)

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

getTransform

public final AffineTransform getTransform()

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

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

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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/awt/image/AffineTransformOp.html