Spec-Zone.ru › OpenJDK 17

Класс 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 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)
Возвращает прямоугольник (bounding box) преобразованного целевого изображения.
final Rectangle2D getBounds2D(Raster src)
Возвращает прямоугольник (bounding box) преобразованного целевого изображения.
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 - если преобразование необратимо.
См. также:
  • 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.

Бросается исключение IllegalArgumentException, если исходное и целевое изображения одинаковые.

Определено в:
filter в интерфейсе BufferedImageOp
Параметры:
src - Преобразуемое BufferedImage.
dst - BufferedImage для хранения результатов преобразования.
Возвращает:
Отфильтрованное BufferedImage.
Исключения:
IllegalArgumentException - если исходное и целевое изображения идентичны
ImagingOpException - если изображение нельзя преобразовать из-за ошибки обработки данных, которая может быть вызвана некорректным форматом изображения, форматом плитки или операцией обработки изображения, или любой другой неподдерживаемой операцией.

filter

public final WritableRaster filter(Raster src, WritableRaster dst)
Преобразует исходное Raster и сохраняет результат в целевом Raster. Эта операция выполняет преобразование по каждому каналу.

Если целевое Raster равно null, создаётся новое Raster . Может быть брошено исключение IllegalArgumentException, если исходное и целевое изображения одинаковые, или если количество каналов в исходном не равно количеству каналов в целевом.

Координаты прямоугольника, возвращаемого методом getBounds2D(Raster), необязательно совпадают с координатами прямоугольника, возвращаемого этим методом. Если координаты верхнего левого угла прямоугольника отрицательные, эта часть прямоугольника не отображается. Если координаты положительные, отфильтрованное изображение отображается в этом положении в целевом 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()
Возвращает аффинное преобразование, используемое этой операцией преобразования.
Возвращает:
Преобразование, связанное с этой операцией.

getRenderingHints

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

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API