Класс AffineTransformOp

java.lang.Object

java.awt.image.AffineTransformOp

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

public class AffineTransformOp extends Object implements BufferedImageOp, RasterOp

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

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

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

Исходный и целевой объекты должны быть разными.
Для объектов 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()`	Возвращает аффинное преобразование, используемое этой операцией преобразования.

Методы, объявленные в классе 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, 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://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/java/awt/image/AffineTransformOp.html