Spec-Zone.ru › OpenJDK 8

Класс 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 на основе аффинного преобразования и типа интерполяции.

AffineTransformOp(AffineTransform xform, RenderingHints hints)

Конструирует AffineTransformOp на основе аффинного преобразования.

Методы

Модификатор и тип Метод и описание
BufferedImage createCompatibleDestImage(BufferedImage src, ColorModel destCM)

Создает целевое изображение с нулевыми значениями, соответствующего размера и количества каналов.

WritableRaster createCompatibleDestRaster(Raster src)

Создаёт нулевое целевое Raster с правильным размером и количеством каналов.

BufferedImage filter(BufferedImage src, BufferedImage dst)

Преобразует исходное BufferedImage и сохраняет результаты в целевом BufferedImage.

WritableRaster filter(Raster src, WritableRaster dst)

Преобразует исходное Raster и сохраняет результаты в целевом Raster.

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.

Spec-Zone.ru

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