Класс 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, количество каналов в исходном изображении должно быть равно количеству каналов в целевом изображении.
- См. также:
-
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(AffineTransform xform,
RenderingHints hints) Конструирует |
Методы
| Модификатор и тип | Метод и описание |
|---|---|
BufferedImage |
createCompatibleDestImage(BufferedImage src,
ColorModel destCM) Создает целевое изображение с нулевыми значениями, соответствующего размера и количества каналов. |
WritableRaster |
createCompatibleDestRaster(Raster src) Создаёт нулевое целевое |
BufferedImage |
filter(BufferedImage src,
BufferedImage dst) Преобразует исходное |
WritableRaster |
filter(Raster src,
WritableRaster dst) Преобразует исходное |
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, создаётся новое изображение с размером и цветовой моделью исходного 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) Создаёт нулевое целевое изображение с правильным размером и количеством каналов. Может быть брошено исключение, если преобразованная ширина или высота равна 0.
Если destCM равно null, используется подходящая цветовая модель; это может быть цветовая модель с альфа-каналом, даже если исходное изображение непрозрачное.
- Задано в:
-
createCompatibleDestImageв интерфейсеBufferedImageOp - Параметры:
-
src- ПреобразуемоеBufferedImage. -
destCM- Цветовая модель целевого изображения. Если null, используется соответствующая цветовая модель. - Возвращает:
- Нулевое целевое изображение.
createCompatibleDestRaster
public WritableRaster createCompatibleDestRaster(Raster src)
Создаёт нулевое целевое растровое изображение с правильным размером и количеством каналов. Может быть брошено исключение, если преобразованная ширина или высота равна 0.
- Задано в:
-
createCompatibleDestRasterв интерфейсеRasterOp - Параметры:
-
src- ПреобразуемоеRaster. - Возвращает:
- Нулевое целевое растровое изображение.
getPoint2D
public final Point2D getPoint2D(Point2D srcPt,
Point2D dstPt) Возвращает координаты соответствующей точки в целевом изображении для заданной точки в исходном изображении. Если dstPt указан, используется для хранения возвращаемого значения.
- Задано в:
-
getPoint2Dв интерфейсеBufferedImageOp - Задано в:
-
getPoint2Dв интерфейсеRasterOp - Параметры:
-
srcPt-Point2D, представляющая точку в исходном изображении. -
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.