Класс 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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Показывает, равен ли какой-либо другой объект этому объекту.
`protected void`	`finalize()`	Устарело, планируется удаление: этот элемент API планируется удалить в одной из будущих версий. Финализация объявлена устаревшей и планируется к удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова метода notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова метода notify или interrupt, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова метода notify или interrupt, либо до истечения заданного промежутка реального времени.

Подробное описание полей

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, возвращаемого этим методом. Если приложение предоставляет dst, он всегда возвращается. Если dst имеет значение null и невозможно создать целевой {code BufferedImage} с преобразованными размерами, будут использованы размеры src.

Если координаты верхнего левого угла прямоугольника отрицательны, эта часть прямоугольника не рисуется. Если координаты верхнего левого угла прямоугольника положительны, отфильтрованное изображение рисуется в этой позиции целевого 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, возвращаемого этим методом. Если приложение предоставляет dst, он всегда возвращается. Если dst имеет значение null и невозможно создать целевой {code Raster} с преобразованными размерами, будут использованы размеры src.

Если координаты верхнего левого угла прямоугольника отрицательны, эта часть прямоугольника не рисуется. Если координаты прямоугольника положительны, отфильтрованное изображение рисуется в этой позиции целевого 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.