Класс RenderableImageOp

java.lang.Object
- java.awt.image.renderable.RenderableImageOp

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

public class RenderableImageOp
extends Object
implements RenderableImage

Этот класс обрабатывает рендерируемые аспекты операции с помощью связанного экземпляра ContextualRenderedImageFactory.

Поля

Поля, объявленные в интерфейсе java.awt.image.renderable.RenderableImage

HINTS_OBSERVED

Конструкторы

Конструктор	Описание
`RenderableImageOp(ContextualRenderedImageFactory CRIF, ParameterBlock paramBlock)`	Создаёт RenderedImageOp, используя объект ContextualRenderedImageFactory и ParameterBlock, содержащий RenderableImage-источники и другие параметры.

Методы

Модификатор и тип	Метод	Описание
`RenderedImage`	`createDefaultRendering()`	Получает экземпляр RenderedImage этого изображения с шириной и высотой по умолчанию в пикселях.
`RenderedImage`	`createRendering(RenderContext renderContext)`	Создаёт RenderedImage, представляющий этот RenderableImageOp (включая его Renderable-источники), рендеренный в соответствии с заданным RenderContext.
`RenderedImage`	`createScaledRendering(int w, int h, RenderingHints hints)`	Создаёт экземпляр RenderedImage этого изображения с шириной w и высотой h в пикселях.
`float`	`getHeight()`	Получает высоту в пространстве координат пользователя.
`float`	`getMinX()`	Получает минимальную координату X данных изображения, независимых от рендеринга.
`float`	`getMinY()`	Получает минимальную координату Y данных изображения, независимых от рендеринга.
`ParameterBlock`	`getParameterBlock()`	Возвращает ссылку на текущий блок параметров.
`Object`	`getProperty(String name)`	Получает свойство из набора свойств этого изображения.
`String[]`	`getPropertyNames()`	Возвращает список имён, распознаваемых getProperty.
`Vector<RenderableImage>`	`getSources()`	Возвращает вектор RenderableImages, которые являются источниками данных изображения для этого RenderableImage.
`float`	`getWidth()`	Получает ширину в пространстве координат пользователя.
`boolean`	`isDynamic()`	Возвращает true, если последовательные рендеринги (то есть вызовы createRendering() или createScaledRendering()) с теми же аргументами могут производить разные результаты.
`ParameterBlock`	`setParameterBlock(ParameterBlock paramBlock)`	Изменяет текущий ParameterBlock операции, позволяя редактировать цепочки рендеринга изображений.

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Конструкторы

RenderableImageOp

public RenderableImageOp(ContextualRenderedImageFactory CRIF,
                         ParameterBlock paramBlock)

Создаёт RenderedImageOp, используя объект ContextualRenderedImageFactory и ParameterBlock, содержащий источники RenderableImage и другие параметры. Источники RenderedImage, указанные в ParameterBlock, будут проигнорированы.

Параметры:: CRIF - объект ContextualRenderedImageFactory; paramBlock - ParameterBlock, содержащий исходные изображения для данной операции и другие параметры, необходимые для её выполнения.

Методы

getSources

public Vector<RenderableImage> getSources()

Возвращает вектор RenderableImages, являющихся источниками данных изображения для этого RenderableImage. Обратите внимание, что этот метод может вернуть пустой вектор, чтобы указать, что изображение не имеет источников, или null, чтобы указать, что информация недоступна.

Определено в:: getSources в интерфейсе RenderableImage
Возвращает:: вектор (возможно, пустой) RenderableImages или null.

getProperty

public Object getProperty(String name)

Получает свойство из набора свойств этого изображения. Если имя свойства не распознано, возвращается java.awt.Image.UndefinedProperty.

Определено в:: getProperty в интерфейсе RenderableImage
Параметры:: name - имя свойства для получения в виде строки.
Возвращает:: ссылка на объект свойства или значение java.awt.Image.UndefinedProperty.

getPropertyNames

public String[] getPropertyNames()

Возвращает список имён, распознаваемых методом getProperty.

Определено в:: getPropertyNames в интерфейсе RenderableImage
Возвращает:: список имён свойств.

isDynamic

public boolean isDynamic()

Возвращает true, если последовательные рендеринги (то есть вызовы createRendering() или createScaledRendering()) с теми же аргументами могут привести к разным результатам. Этот метод можно использовать для определения, может ли существующий рендеринг быть кэширован и повторно использован. Будет вызван метод isDynamic CRIF.

Определено в:: isDynamic в интерфейсе RenderableImage
Возвращает:: true если последовательные рендеринги с теми же аргументами могут привести к разным результатам; false в противном случае.

getWidth

public float getWidth()

Получает ширину в пространстве пользовательских координат. По соглашению, обычная ширина RenderableImage равна коэффициенту изображения (ширина, делённая на высоту).

Определено в:: getWidth в интерфейсе RenderableImage
Возвращает:: ширину изображения в пользовательских координатах.

getHeight

public float getHeight()

Получает высоту в пространстве пользовательских координат. По соглашению, обычная высота RenderedImage равна 1.0F.

Определено в:: getHeight в интерфейсе RenderableImage
Возвращает:: высоту изображения в пользовательских координатах.

getMinX

public float getMinX()

Получает минимальную координату X независимых от рендеринга данных изображения.

Определено в:: getMinX в интерфейсе RenderableImage
Возвращает:: минимальную координату X независимых от рендеринга данных изображения.

getMinY

public float getMinY()

Получает минимальную координату Y независимых от рендеринга данных изображения.

Определено в:: getMinY в интерфейсе RenderableImage
Возвращает:: минимальную координату Y независимых от рендеринга данных изображения.

setParameterBlock

public ParameterBlock setParameterBlock(ParameterBlock paramBlock)

Изменяет текущий ParameterBlock операции, позволяя редактировать цепочки рендеринга изображений. Эффекты такого изменения будут видны при создании нового рендеринга из этого RenderableImageOp или любого зависимого RenderableImageOp.

Параметры:: paramBlock - новый ParameterBlock.
Возвращает:: старый ParameterBlock.
См. также:: getParameterBlock()

getParameterBlock

public ParameterBlock getParameterBlock()

Возвращает ссылку на текущий блок параметров.

Возвращает:: ParameterBlock этого RenderableImageOp.
См. также:: setParameterBlock(ParameterBlock)

createScaledRendering

public RenderedImage createScaledRendering(int w,
                                           int h,
                                           RenderingHints hints)

Создаёт экземпляр RenderedImage этого изображения с шириной w и высотой h в пикселях. RenderContext создаётся автоматически с соответствующим преобразованием usr2dev и областью интереса всего изображения. Все параметры рендеринга берутся из переданных.

Если w == 0, оно будет равно Math.round(h*(getWidth()/getHeight())). Аналогично, если h == 0, оно будет равно Math.round(w*(getHeight()/getWidth())). Одно из w или h должно быть ненулевым, иначе будет брошено исключение IllegalArgumentException.

Созданный RenderedImage может иметь свойство, идентифицируемое строкой HINTS_OBSERVED, указывающей, какие RenderingHints были использованы для создания изображения. Кроме того, любые RenderedImages, полученные через метод getSources() на созданном RenderedImage, могут иметь такое свойство.

Определено в:: createScaledRendering в интерфейсе RenderableImage
Параметры:: w - ширина рендерного изображения в пикселях, или 0.; h - высота рендерного изображения в пикселях, или 0.; hints - объект RenderingHints, содержащий параметры.
Возвращает:: RenderedImage, содержащий рендеренные данные.

createDefaultRendering

public RenderedImage createDefaultRendering()

Получает экземпляр RenderedImage этого изображения с шириной и высотой по умолчанию в пикселях. RenderContext создаётся автоматически с соответствующим преобразованием usr2dev и областью интереса всего изображения. Все параметры рендеринга берутся из переданных.

Определено в:: createDefaultRendering в интерфейсе RenderableImage
Возвращает:: RenderedImage, содержащий рендеренные данные.

createRendering

public RenderedImage createRendering(RenderContext renderContext)

Создаёт RenderedImage, представляющий этот RenderableImageOp (включая его Renderable-источники), рендеренный в соответствии с заданным RenderContext.

Этот метод поддерживает цепочку операций Renderable или RenderedImage. Если источники в ParameterBlock, используемом для создания RenderableImageOp, являются RenderedImages, то выполняется трёхэтапный процесс:

mapRenderContext() вызывается для каждого RenderableImage-источника в ассоциированном CRIF;
createRendering() вызывается для каждого из RenderableImage-источников с использованием обратного преобразования RenderContext, полученного на шаге 1, что приводит к рендерингу каждого источника;
ContextualRenderedImageFactory.create() вызывается с новым ParameterBlock, содержащим параметры RenderableImageOp и RenderedImages, которые были созданы вызовами createRendering().

Если элементы вектора источников в ParameterBlock, используемом для создания RenderableImageOp, являются экземплярами RenderedImage, то метод CRIF.create() вызывается сразу с исходным ParameterBlock. Это обеспечивает базовый случай для рекурсии.

Созданный RenderedImage может иметь свойство, идентифицируемое строкой HINTS_OBSERVED, указывающей, какие RenderingHints (из RenderContext) были использованы для создания изображения. Кроме того, любые RenderedImages, полученные через метод getSources() на созданном RenderedImage, могут иметь такое свойство.

Определено в:: createRendering в интерфейсе RenderableImage
Параметры:: renderContext - RenderContext, который следует использовать для выполнения рендеринга.
Возвращает:: RenderedImage, содержащий желаемое выходное изображение.

© 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.
https://docs.oracle.com/en/java/javase/11/docs/api/java.desktop/java/awt/image/renderable/RenderableImageOp.html