Класс RenderableImageOp

java.lang.Object

java.awt.image.renderable.RenderableImageOp

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

public class RenderableImageOp extends Object implements RenderableImage

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

Краткое описание полей

Поля, объявленные в интерфейсе 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()`	Возвращает вектор объектов RenderableImage, являющихся источниками данных изображения для этого RenderableImage.
`float`	`getWidth()`	Получает ширину в пользовательском пространстве координат.
`boolean`	`isDynamic()`	Возвращает true, если последовательные операции рендеринга (то есть вызовы createRendering() или createScaledRendering()) с одинаковыми аргументами могут давать разные результаты.
`ParameterBlock`	`setParameterBlock(ParameterBlock paramBlock)`	Изменяет текущий ParameterBlock операции, позволяя редактировать цепочки рендеринга изображений.

Методы, объявленные в классе 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()

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

Указано в:: getSources в интерфейсе RenderableImage
Возвращает:: вектор RenderableImage (возможно, пустой) или 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 использовались для создания изображения. Кроме того, такое свойство могут иметь любые изображения RenderedImage, полученные с помощью метода 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, являются объекты RenderableImage, выполняются три этапа:

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

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

Созданное изображение RenderedImage может иметь свойство, идентифицируемое строкой HINTS_OBSERVED, указывающее, какие RenderingHints (из RenderContext) использовались для создания изображения. Кроме того, такое свойство могут иметь любые изображения RenderedImage, полученные с помощью метода 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://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/java/awt/image/renderable/RenderableImageOp.html