Spec-Zone.ru › OpenJDK 8

Класс 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, то выполняется трёхэтапный процесс:

  1. mapRenderContext() вызывается для каждого источника RenderableImage связанного CRIF;
  2. createRendering() вызывается для каждого из источников RenderableImage, используя полученные в шаге 1 обратные преобразования RenderContext, в результате чего каждый источник рендерится;
  3. 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.

Spec-Zone.ru

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