Класс RenderableImageOp

java.lang.Object

java.awt.image.renderable.RenderableImageOp

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

public class RenderableImageOp extends Object implements RenderableImage

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

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

Поля, объявленные в интерфейсе RenderableImage

HINTS_OBSERVED

Модификатор и тип	Поле	Описание
`static final String`	`HINTS_OBSERVED`	Строковая константа, которую можно использовать для идентификации свойства объекта RenderedImage, полученного с помощью методов createRendering или createScaledRendering.

Краткое описание конструкторов

Конструктор	Описание
`RenderableImageOp(ContextualRenderedImageFactory CRIF, ParameterBlock paramBlock)`	Создает `RenderableImageOp` с объектом 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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли этот объект какому-либо другому объекту.
`protected void`	`finalize()`	Устарело, планируется удаление: этот элемент API может быть удален в будущей версии. Финализация устарела и может быть удалена в одном из следующих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает значение хеш-кода этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Приостанавливает текущий поток до его пробуждения, обычно посредством уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Приостанавливает текущий поток до его пробуждения, обычно посредством уведомления или прерывания, либо до истечения заданного интервала реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Приостанавливает текущий поток до его пробуждения, обычно посредством уведомления или прерывания, либо до истечения заданного интервала реального времени.

Подробное описание конструкторов

RenderableImageOp

public RenderableImageOp(ContextualRenderedImageFactory CRIF, ParameterBlock paramBlock)

Создает RenderableImageOp с объектом ContextualRenderedImageFactory и ParameterBlock, содержащим источники RenderableImage и другие параметры. Все источники RenderedImage, указанные в ParameterBlock, игнорируются.

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

Подробное описание методов

getSources

public Vector<RenderableImage> getSources()

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

Определено в:: getSources в интерфейсе RenderableImage
Возвращает:: (возможно, пустой) Vector объектов 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 может иметь свойство с именем String 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().

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

Созданный объект RenderedImage может иметь свойство с именем String 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.