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

public ParameterBlock getParameterBlock()

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

Возвращает:

текущий ParameterBlock данного RenderableImageOp.

См. также:

createScaledRendering

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

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

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

Определено в:: 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, 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/awt/image/renderable/RenderableImageOp.html